Skip to main content

Claude Code

Drop our agent skills into Claude Code so the model knows how to wire up Address Finder, Postcode Lookup, the API, and the CLI without trial-and-error.

Install

One command, from inside your repo:

npx skills add ideal-postcodes/skills

This installs four skills under .claude/skills/:

  • address-finder — multi-country address autocomplete widget
  • postcode-lookup — UK postcode → address dropdown
  • api — direct HTTP integration
  • idpc-cli — non-interactive CLI for account, key, and address operations

Skills load automatically when Claude Code opens the repo.

Verify

Ask Claude Code:

What's the npm install command for the Ideal Postcodes Address Finder?

The skill should produce @ideal-postcodes/address-finder without prompting you to search the web.

API key

  • Quick test: ak_test (capped at 5 lookups/day, public, breaks in production).
  • Real key: sign up for a free trial balance.
  • Before deploy: restrict the key via Allowed URLs.

Going deeper

Need help?