For site operators

TownSignalBot.

TownSignalBot is the client TownSignal uses to read the Massachusetts Attorney General’s public by-law decision letters. Questions or a request to stop: support@townsignal.co.

What it fetches

Public decision letters from the Attorney General’s Municipal Law Unit by-law decision look-up, for the towns TownSignal covers. It runs the look-up’s search for one town and one year at a time, then downloads the letters that search lists. It does not sign in and does not fetch anything a visitor without an account could not open.

How it identifies itself

Every request sends this User-Agent:

TownSignalBot/0.1 (AG decision archive; +https://www.townsignal.co/bot/; support@townsignal.co)

How fast

One request at a time, with at least 5 seconds between requests to the same host. A server or network error is retried at most twice, after waiting 2 and then 4 seconds. Runs are started by hand, not on a schedule.

When it stops

A 401, 403 or 429 response, a CAPTCHA, or any page that is not the expected search result or PDF stops the run. TownSignalBot does not retry those with a browser or a different identity, and does not try to get past an access control.

Contact

Email support@townsignal.co to ask a question, to ask for a slower rate, or to ask TownSignalBot to stop. Postal address: 128 Briarwood Dr, Hanover, MA 02339.