Skip to main content
Glama
postio-uk

Postio

Official

postio-integrations

JS 系列 npm 包、AI / 代理界面,以及驱动 Postio 浏览器嵌入功能的 cdn.postio.co.uk Worker。

Postio API 和 OpenAPI 规范位于 postio-uk/postio-api。该规范也作为 @postio/openapi 发布。

软件包

软件包

说明

@postio/api-types

从 OpenAPI 规范生成的 TypeScript 类型。

@postio/core

与运行时无关的类型化客户端(浏览器 / Node / Workers / Bun / Deno)。

@postio/node

基于 core 构建的 Node SDK — 支持指数退避重试,提供结构化日志记录钩子。

@postio/postman-collection

涵盖每个端点的 Postman v2.1 集合。

@postio/address-finder

浏览器地址自动补全 — ARIA 组合框,可设置主题,与框架无关的源。

@postio/address-finder-bundled

预构建的相同组件,供 <script> 标签使用。

@postio/react

React 钩子 + <AddressFinder /> 组件,底层使用 TanStack Query。

@postio/mcp

模型上下文协议 (MCP) 服务器 — 可通过 npx -y @postio/mcp 用于 Claude Desktop / Cursor / Windsurf / Zed。

Related MCP server: APITier MCP Server

布局

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

构建

cd packages
pnpm install
pnpm -r run build

每个软件包均独立构建(pnpm -F @postio/<name> run build)。 address-finder 捆绑包具有拓扑构建特性 — 请使用 ... 后缀,以便其工作区依赖项优先构建:

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

贡献

欢迎提交 PR。约定:

  • Node 22+,pnpm 10+,仅限 ESM,MIT 许可。

  • stage 为工作分支;master 通过 CI 进行部署/发布。

  • 尽可能每个 PR 只更改一个软件包。

  • 每个软件包的版本遵循独立的语义化版本控制 (SemVer);当您打算发布时,请在 package.json 中提升版本号。

完整的集成索引(包括各自仓库中的服务器 SDK 和 WordPress 插件)位于 postio.co.uk/integrations。

许可证

MIT。

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Global postal code lookups, validation, and city search for 240+ countries with timezone, admin region, and elevation metadata. Sub-10ms responses at $0.000028/query with 1,000 free queries on signup.
    4
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    About MCP server exposing 10 APITier utility APIs as AI agent tools — email/phone/VAT validation, UK postcodes, India pincodes, barcode/QR generation, data conversion
    48 npm
    MIT
  • A
    license
    A
    quality
    F
    maintenance
    Enables address validation, geocoding, postcode lookup, and reverse geocoding in 240+ countries, including UK Royal Mail PAF data, through four tools for MCP-aware clients.
    4
    33 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Keyless email validation: disposable/burner, role-account, and free-provider detection, MX checks, and typo suggestions. Tools: check_email, check_domain.
    MIT