English Français العربية

Postio — UK Address, Postcode, Email & Phone Validation

السجل الرسمي الإنتاجية

Validate UK addresses, postcodes, emails and phone numbers — Royal Mail PAF, live SMTP and HLR.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @postio/mcp
Claude Code 
claude mcp add postio-uk-address-postcode-email-phone-v -e 'POSTIO_API_KEY=<your postio_api_key>' -e 'POSTIO_BASE_URL=<POSTIO_BASE_URL>' -- npx -y @postio/mcp@0.1.5
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "postio-uk-address-postcode-email-phone-v": {
            "command": "npx",
            "args": [
                "-y",
                "@postio/mcp@0.1.5"
            ],
            "env": {
                "POSTIO_API_KEY": "<your postio_api_key>",
                "POSTIO_BASE_URL": "<POSTIO_BASE_URL>"
            }
        }
    }
}

متغيرات البيئة

  • POSTIO_API_KEY إلزامي سري Postio API key (pk_…). Free key, first 100 lookups on us, no card: https://postio.co.uk/signup
  • POSTIO_BASE_URL Override the API base URL. Defaults to https://api.postio.co.uk/v1 (include /v1). Only needed for staging.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. postio-integrations
  2. Packages
  3. Layout
  4. Building
  5. Contributing
  6. License

postio-integrations

Postio is the UK validation API for addresses, emails and phone numbers. This repo holds the JS-family npm packages, the AI / agent surface, and the cdn.postio.co.uk Worker that powers Postio's browser drop-in.

First time? Sign up free — first 100 lookups on us, no card needed.

The Postio API + OpenAPI spec live in postio-uk/postio-api. The spec is also published as @postio/openapi.

Packages

PackageWhat it is
@postio/api-typesTypeScript types generated from the OpenAPI spec.
@postio/coreRuntime-agnostic typed client (browser / Node / Workers / Bun / Deno).
@postio/nodeNode SDK on top of core — retries with exponential backoff, structured logger hook.
@postio/postman-collectionPostman v2.1 collection for every endpoint.
@postio/address-finderBrowser address autocomplete — ARIA combobox, themable, framework-agnostic source.
@postio/address-finder-bundledThe same component prebuilt for <script> tag use.
@postio/reactReact hooks + <AddressFinder /> component, TanStack Query under the hood.
@postio/mcpModel Context Protocol server — npx -y @postio/mcp for Claude Desktop / Cursor / Windsurf / Zed.

Layout

packages/         pnpm workspace; one publishable npm package per subdir
ai/               AI / agent surface (Claude Skill, GPT Action, recommendation prompts)
cdn-worker/       Cloudflare Worker that serves the address-finder bundles
.github/workflows/  CI for publishing + deploying

Building

cd packages
pnpm install
pnpm -r run build

Each package builds independently (pnpm -F @postio/<name> run build). The address-finder bundle has a topological-build quirk — use the ... suffix so its workspace dep builds first:

pnpm -F "@postio/address-finder-bundled..." run build

Contributing

PRs welcome. Conventions:

  • Node 22+, pnpm 10+, ESM only, MIT-licensed.
  • stage is the working branch; master deploys / publishes via CI.
  • One package change per PR where possible.
  • Versions on each package are independent SemVer; bump the version in package.json when you intend a release.

The full integration index — including the server SDKs in their own repos and the WordPress plugin — lives at postio.co.uk/integrations.

License

MIT.

الأسئلة الشائعة

ما هو Postio — UK Address, Postcode, Email & Phone Validation؟

Validate UK addresses, postcodes, emails and phone numbers — Royal Mail PAF, live SMTP and HLR.

كيف أثبّت Postio — UK Address, Postcode, Email & Phone Validation؟

يعمل على جهازك. في Claude Code: claude mcp add postio-uk-address-postcode-email-phone-v -e 'POSTIO_API_KEY=<your postio_api_key>' -e 'POSTIO_BASE_URL=<POSTIO_BASE_URL>' -- npx -y @postio/mcp@0.1.5. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Postio — UK Address, Postcode, Email & Phone Validation إلى مفتاح API؟

نعم. يتطلب POSTIO_API_KEY، وتضبطها في إعداداته.

هل Postio — UK Address, Postcode, Email & Phone Validation مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Postio — UK Address, Postcode, Email & Phone Validation؟

ينشره postio-uk. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.