Skip to main content
Glama
deenesjakoruzh
torify-dev

Torify — Japanese Locale APIs for AI Agents

by torify-dev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Remote

torify-examples

Torify — AI 에이전트를 위한 일본 로케일 API의 코드 예제입니다.

와레키(연호), 청구서 검증, 법인 조회, 주소 정규화 등을 위한 31개의 엔드포인트를 제공합니다.

torify.dev License: MIT

빠른 시작

무료 티어 (MCP — 지갑 및 가입 불필요)

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "torify": {
      "type": "http",
      "url": "https://torify-mcp.torify.workers.dev"
    }
  }
}

IP당 하루 100회 요청 무료. Claude Desktop 및 Cursor에서 작동합니다.

x402 호출당 요금 (Base L2에서 $0.02 USDC)

npm install x402-fetch viem
export PRIVATE_KEY="0x..."
npx ts-node typescript/x402-example.ts

API 키 구독 (월 $49)

export TORIFY_API_KEY="your-key"
npx ts-node typescript/apikey-example.ts

Related MCP server: japan-ux-mcp

예제

와레키(연호) 변환

# Gregorian → Wareki
curl "https://torify.dev/v1/wareki/convert?direction=g2w&date=2024-05-01"
# { "ok": true, "data": { "era": "令和", "eraYear": 6, "formatted": "令和6年5月1日" } }

# Wareki → Gregorian (edge case: Showa ended Jan 7, 1989; Heisei started Jan 8, 1989)
curl "https://torify.dev/v1/wareki/convert?direction=w2g&era=showa&eraYear=64&month=1&day=7"
# { "ok": true, "data": { "gregorian": "1989-01-07" } }

청구서 번호 검증

# Format + check digit validation (no payment needed)
curl "https://torify.dev/v1/invoice/validate?number=T8010401050783"
# { "ok": true, "data": { "valid": true } }

상태: NTA 레지스트리 연동은 외부 API 승인 대기 중입니다. 곧 제공될 예정입니다.

# NTA registry lookup — is this T-number actually registered?
curl "https://torify.dev/v1/invoice/verify?number=T8010401050783" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "registered": true, "registrantName": "国税庁", "confidence": 0.99 } }

법인 번호 조회

상태: 법인 번호 조회는 외부 API 승인 대기 중입니다. 곧 제공될 예정입니다.

curl "https://torify.dev/v1/houjin/lookup?number=8010401050783" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "name": "国税庁", "address": "東京都千代田区霞が関3丁目1番1号", "status": "active" } }

우편번호 조회

curl "https://torify.dev/v1/postal/lookup?zipcode=1000013"
# { "ok": true, "data": { "prefecture": "東京都", "city": "千代田区", "town": "霞が関" } }

전화번호 검증

# Tokyo (2-digit area code 03)
curl "https://torify.dev/v1/phone/validate?phone=03-1234-5678"
# { "ok": true, "data": { "valid": true, "type": "landline", "region": "東京" } }

# Rural (4-digit area code 0266)
curl "https://torify.dev/v1/phone/validate?phone=0266-12-3456"
# { "ok": true, "data": { "valid": true, "type": "landline", "region": "長野" } }

주소 정규화

curl "https://torify.dev/v1/address/normalize" \
  --get --data-urlencode "address=東京都千代田区霞が関3丁目1番1号" \
  -H "X-API-Key: $TORIFY_API_KEY"
# { "ok": true, "data": { "prefecture": "東京都", "city": "千代田区", "town": "霞が関", "block": "3丁目1番1号" } }

x402를 사용한 TypeScript (자동 결제)

import { wrapFetchWithPayment } from "x402-fetch";
import { createWalletClient, http } from "viem";
import { base } from "viem/chains";
import { privateKeyToAccount } from "viem/accounts";

const wallet = createWalletClient({
  account: privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`),
  chain: base,
  transport: http()
});
const fetch402 = wrapFetchWithPayment(fetch, wallet);

// Agent pays $0.02 USDC automatically — no API key needed
const res = await fetch402("https://torify.dev/v1/invoice/verify?number=T8010401050783");
const { ok, data } = await res.json();
console.log(data.registered, data.confidence); // true, 0.99

API 키를 사용한 Python

import os, requests

headers = {"X-API-Key": os.environ["TORIFY_API_KEY"]}

r = requests.get(
    "https://torify.dev/v1/address/normalize",
    params={"address": "東京都千代田区霞が関3丁目1番1号"},
    headers=headers
)
data = r.json()["data"]
print(data["prefecture"], data["city"], data["town"])
# 東京都 千代田区 霞が関

전체 엔드포인트

전체 문서: torify.dev/docs

카테고리

엔드포인트

연호 및 날짜

wareki/convert, holiday/check, age/calculate

법률 및 세금

invoice/validate, invoice/verify, tax/calculate

법인

houjin/lookup, industry/lookup

주소

postal/lookup, address/normalize, region/lookup

텍스트

name/romanize, kanji/to-kana, kana/convert, text/normalize

금융

bank/lookup, bank/transfer/validate, yucho/convert

신원 확인

mynumber/validate, phone/validate, passport/validate

라이선스

MIT — 예제 코드에만 해당합니다. Torify API 서비스는 독점 소프트웨어입니다.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessWithin a week

Resources

Related MCP Connectors

Related MCP Servers

  • japan-ux-mcp

    mrslbt
    A
    license
    A
    quality
    C
    maintenance
    Provides Japanese UX conventions as an MCP server to help AI generate correct Japanese UI elements like proper name order, furigana, phone formats, and polite language. It includes tools for form generation, validation, keigo suggestions, and cultural adaptation for developers building Japanese-facing products.
    6
    80 npm
    MIT

  • japan-utils-mcp

    vivek081166
    A
    license
    A
    quality
    C
    maintenance
    Japan-specific utilities for AI agents — era ↔ Western year conversion, kanji-to-romaji, postal code lookup, national holidays, kana conversion, and Japanese name splitting. 9 tools, MIT licensed, install via uvx.
    9
    29 PyPI
    MIT