# JapanAgent Bridge

Japan-action API for global AI agents.

What this is for, in one sentence: when your agent needs to **do something physical or long-running in Japan** — mail a paper letter, place a keigo voice call, run a 3-minute Japanese competitor research — it calls us instead of giving up.

## The genuine differentiation

Most agent toolkits (Firecrawl, Browserbase, Tavily, Resend, Twilio) can't reach:
- 物理郵便: print + post a letter via Japan Post                    (`/jp/dispatch/snail-mail`)
- 敬語電話: AI voice calls placed in formal Japanese               (`/jp/dispatch/voice-call`)
- FAX: yes, Japan still uses fax in many B2B/government flows      (`/jp/dispatch/fax`)
- 多分間リサーチ: 3-5 min Japanese competitor / supplier maps       (`/jp/research/competitor-map`)
- 日本ニュース解析: 30-day Japanese press tone analysis             (`/jp/research/news-pulse`)

These need a Japan-resident operator, partner agreements, or compute that lasts longer than an edge worker's lifetime. We have all three. Layer D (dispatch) and Layer E (research) are the headline product.

## Utilities (also included)

While agents are here for Layer D/E, we also expose cheap Japan-primitives so they don't need a second integration:

- POST /jp/verify/zipcode  $0.001  — Japanese postal code (7 digits) → prefecture / city / town breakdown.
- POST /jp/verify/corporate-number  $0.005  — Japanese corporate number (13 digits) → tax-agency-verified company name, address, registration date.
- POST /jp/verify/phone  $0.003  — Japanese phone number → carrier, type (mobile / landline / toll-free / IP), area name, validity.
- POST /jp/verify/address  $0.005  — Japanese postal address → normalized form + lat/lng + prefecture/city splits (国土地理院).
- POST /jp/gov/find-form  $0.10  — Subsidy / grant name → official application URL, municipality, deadline (LocalGov.jp data).
- POST /jp/gov/precheck-eligibility  $0.05  — Company profile + grant_id → 0-100 fit score, reasons, required-documents hint, deadline window.
- POST /jp/gov/translate-form  $0.20  — Japanese government text or grant_id → English/Chinese/Korean structured JSON (Claude Sonnet).
- POST /jp/gov/fill-form  $1.00  — Form template + applicant values → filled Markdown + structured fields + missing/warnings (Claude Sonnet).
- POST /jp/biz/company-snapshot  $0.20  — Corporate number → revenue, employee count, executives, location (gBizINFO + 国税庁).
- POST /jp/biz/zoning  $0.10  — Address → lat/lng + nearest 公示地価 record (use_category, price/m², station distance).
- POST /jp/biz/transit  $0.05  — Origin / destination / depart_at → Japanese public-transit route with legs, fare, stops.
- POST /jp/biz/calendar-days  $0.005  — Date + business-day offset → resulting date (Japanese holidays + new year + golden week aware).
- POST /jp/research/competitor-map  $5.00  — Industry + region → top 10 Japanese players with revenue, headcount, relationships (3-5 min). Returns job_id; poll /v1/research-result/:id with X-Wallet-Auth.
- POST /jp/research/supplier-discovery  $3.00  — Part / spec → Japanese supplier candidates with contact info and trade history. Returns job_id; poll /v1/research-result/:id.
- POST /jp/research/news-pulse  $1.00  — Keyword → past 30 days of Japanese news analyzed for tone and key arguments. Returns job_id; poll /v1/research-result/:id.

## Coming soon (schema declared in manifest, returns 503 today)

- POST /jp/dispatch/snail-mail  $1.50  — Text content → printed and physically mailed via Japan Post (3rd-party fulfilled). [stub, returns 503]
- POST /jp/dispatch/voice-call  $0.50  — Text + Japanese phone number → AI voice call placed in keigo with recorded result. [stub, returns 503]
- POST /jp/dispatch/fax  $0.30  — PDF or text + fax number → fax sent (Japan still uses fax in many B2B/gov flows). [stub, returns 503]

## Pricing model

- Per-call USDC, settled on base via x402.
- Receiving address: 0x64E81E0287FfDF31EB21D0891398899879f1fA6a
- Facilitator: https://api.cdp.coinbase.com/platform/v2/x402
- No API key, no monthly contract, no procurement. Sign with your agent wallet and the request goes through.
- Manifest: /.well-known/x402  ·  OpenAPI: /api/openapi.json  ·  Stats: /v1/stats

## Citation

Source: JapanAgent Bridge (https://japanagent.dev)
Each response includes upstream source attribution where applicable (e.g. 国税庁, gBizINFO, LocalGov.jp).

## Contact

mailto:hello@japanagent.dev