uk-companies-houselisted
Install: claude install-skill techhorizonlabs/gearlist
# UK Companies House
The Companies House register of UK companies, searched by name or read by company number through the Companies House public data API.
`scripts/companies_house.py` makes the calls below and prints Markdown, or JSON with `--json`. It uses the Python 3 standard library only, sends read-only GET requests and writes nothing to disk.
## Sign-in: an API key
1. The human registers a Companies House user account at https://developer.company-information.service.gov.uk/, creates an application for the live environment, then creates a key with the client type "API key". GOV.UK's guidance says the data is free through the API.
2. The key lives in the `COMPANIES_HOUSE_API_KEY` environment variable. The script reads it from there and nowhere else. Companies House's developer guidelines advise against putting keys in code and suggest environment variables.
3. Never print, log or save the key, and never put it in a prompt, a file or the chat. The script sends it in an HTTP Basic `Authorization` header, so it never appears in a URL. If `COMPANIES_HOUSE_API_KEY` is not set, stop and ask the human to set it. Do not ask them to paste it into the conversation.
Without a key, the human can search by hand at https://find-and-update.company-information.service.gov.uk/.
## Run
```bash
python3 scripts/companies_house.py "Tesco"
python3 scripts/companies_house.py 00445790
python3 scripts/companies_house.py SC123456 --json
python3 scripts/companies_house.py "Acme Widgets" --li