# civicbot

> civicbot is an open-source civic helper that answers local questions (weather, alerts, air quality, tides,
> earthquakes, transit, recalls, holidays, nearby 311 reports) from free, keyless public APIs, and drafts 311
> reports that the user submits themselves. AI assistants can use it with no account, key or install.

## For AI assistants
- [grok.txt](https://fitzyracing1.github.io/civicbot/grok.txt): instructions plus 37 ready-to-fill GET URL templates. Start here.
- [grok-apis.txt](https://fitzyracing1.github.io/civicbot/grok-apis.txt): 116 verified keyless APIs, one per line.
- [grok-pack.json](https://fitzyracing1.github.io/civicbot/data/grok-pack.json): the same, machine-readable.

## For people
- [Use with Grok](https://fitzyracing1.github.io/civicbot/grok.html): copy-paste prompts, custom instructions and Project text.
- [Free API directory](https://fitzyracing1.github.io/civicbot/apis.html), [Playground](https://fitzyracing1.github.io/civicbot/playground.html), [Source](https://github.com/fitzyracing1/civicbot)

## Rules
- Read-only GET requests to the listed public URLs only. Never file a 311 report, post, or log in for the user.

## Global free-API directory
- [grok-global.txt](https://fitzyracing1.github.io/civicbot/grok-global.txt): 1607 keyless APIs by continent and country, as text files.
- [Global directory](https://fitzyracing1.github.io/civicbot/directory.html): all 6097 verified entries with filters.
- [index.json](https://fitzyracing1.github.io/civicbot/data/directory/index.json): counts and links to per-continent JSON shards.