Medic

Perform bulk URL status checks and track changes.

Getting Started

Install the Medic command line tool:

npm install -g medic

Create a urls.txt file:

---
cookies:
    - Location=nz
---

# Home pages

https://rolandwarmerdam.co.nz/
https://www.google.com/
https://twitter.com/
http://example.com/

Run medic:

medic urls.txt

Also supports piping:

cat urls.txt | medic

Usage

CLI

Usage: medic <path> [<options>]

Path:
    Path to a file containing a list of URLs. Each URL must be on a separate
    line and lines not starting with http:// or https:// are ignored.
    This parameter is ignored when URLs are being piped.
    File can also can also contain YAML front matter with the cookies option.

Options:
    -c  --concurrency Number of concurrent requests per origin. Defaults to 5.
    -h, --help        Show this help text.
    -o, --output      File path to output the results of this run to.
    -p, --compare     Path to a previous results file to compare against.
    -v, --version     Print medic's version.

API

.check(object options, [function callback]) -> Promise

Checks the status of all the passed URLs.

Options

cookies

Type: array

urls

Type: array

onProgress

Type: function<object result>

Gets called on each checked URL and is passed the result.

Example result:

[
  {
    "url": "https://www.google.com/mail/",
    "statusCode": 200,
    "redirectUrl": "https://mail.google.com/mail/"
  }, {
    "url": "http://non-existent.example.com/",
    "error": "getaddrinfo ENOTFOUND"
  }
]

.compare(object options) -> array

Compares 2 result sets to find any changes.

Example return:

[
  {
    "current": {
      "url": "https://reader.google.com/",
      "statusCode": 404
    },
    "previous": {
      "url": "https://reader.google.com/",
      "statusCode": 200
    }
  }
]

Options

currentResults

Type: array

previousResults

Type: array

Related

• sitemap-urls - Extract URLs from an XML sitemap.

License

Medic is released under the MIT license.

Copyright © 2015 Roland Warmerdam.