Torify — Japanese Locale APIs for AI Agents
torify-examples
Примеры кода для Torify — API японской локали для ИИ-агентов.
31 эндпоинт для работы с wareki (даты по эрам), проверки счетов, поиска корпораций, нормализации адресов и многого другого.
Быстрый старт
Бесплатный уровень (MCP — без кошелька, без регистрации)
Добавьте в claude_desktop_config.json:
{
"mcpServers": {
"torify": {
"type": "http",
"url": "https://torify-mcp.torify.workers.dev"
}
}
}100 запросов в день на IP бесплатно. Работает в Claude Desktop и Cursor.
x402 с оплатой за вызов ($0.02 USDC в сети Base L2)
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.tsRelated MCP server: japan-ux-mcp
Примеры
Преобразование Wareki (даты по эрам)
# 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号" } }TypeScript с x402 (автономная оплата)
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.99Python с API-ключом
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 — только для примеров. Сервис API Torify является проприетарным.
This server cannot be deployed
Maintenance
Related MCP Connectors
Japan data tools for AI agents: calendar (rokuyo), address, name splitting, corporate number lookup
Pay-per-call document and web tools for AI agents: PDF parsing and OCR (Japanese-strong), web and structured extraction, invoice verification, company profiles and PDF utilities. x402 (USDC on Base), no API key; failed calls are never charged.
Normalize and romanize Japanese addresses, look up postal codes, count Japanese business days.
Japanese business days, holiday checks and invoice due dates for your AI agent.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides Japanese postal code to address lookup functionality that can be integrated with AI assistants and other MCP clients.3MIT
- AlicenseAqualityCmaintenanceProvides 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.680 npmMIT
- AlicenseAqualityCmaintenanceJapan-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.929 PyPIMIT
- AlicenseAqualityBmaintenanceJapan Operations OS for AI agents — 14 knowledge domains covering regulations, protocols, calendar, travel, food culture, language, disaster safety, daily life, and persistent memory. 31 MCP tools via REST + Streamable HTTP.31MIT