Skip to main content
Glama
postio-uk

Postio

Official

postio-integrations

JS 계열 npm 패키지, AI/에이전트 인터페이스, 그리고 Postio의 브라우저 드롭인을 구동하는 cdn.postio.co.uk 워커입니다.

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

Model Context Protocol 서버 — Claude Desktop / Cursor / Windsurf / Zed용 npx -y @postio/mcp.

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 번들에는 위상 빌드(topological-build) 특이 사항이 있으므로 ... 접미사를 사용하여 워크스페이스 의존성이 먼저 빌드되도록 하십시오:

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