edition-api

EDITION Intelligence Platform

Japan Knowledge Gateway for autonomous AI agents.

20 knowledge domains · 43 MCP tools · 7 Skills Packs · 100+ REST endpoints Verified ground truth for operating in the Japanese market. Quality score: 97.8/100.

Production API: api.edition.sh — Free beta, no registration required.

Interactive Demo: Tourist Agent Demo — Watch 6 domains work together in real-time.

---

Why EDITION?

AI agents working in Japan hit walls that generic LLMs can't solve:

Challenge	What goes wrong
Keigo (敬語)	「お持ちすれば喜ばれるかと存じます」 — hidden subject, layered honorifics, uncertainty expression. Generic NLP treats this as noise.
Implicit agreements	Japanese business communication rarely states things directly. Agents need cultural decoding.
Regulatory maze	10+ industries with overlapping national/prefectural regulations, most documentation only in Japanese.
Procedural complexity	Company incorporation, visa, banking — each requires 5-8 steps with specific documents, deadlines, and costs.

EDITION provides verified, structured intelligence that agents can use as ground truth instead of hallucinating cultural nuances, legal requirements, and procedural details.

---

20 の知識ドメイン

#	ドメイン	ツール	対応内容
1	記憶	memory_store memory_recall memory_facts memory_context memory_extract	日本語の敬語分析と社会的序列の検出を備えた、3 層の永続的な記憶（エピソード／事実／コンテキスト）
2	規制	regulation_check regulation_industries regulation_tourist	10 業種（食品、不動産、金融、医療、建設、教育、運輸、小売、IT、製造）と観光客向けのコンプライアンス
3	プロトコル	protocol_check protocol_list	根回し、稟議、報連相、名刺交換、席順、贈答 — 文化的背景を含む段階的な手順
4	カレンダー	calendar_check calendar_list	4 月始まりの会計年度、ゴールデンウィーク、お盆、年末、贈答シーズン、行政手続きの期限
5	地域	regional_check regional_list	東京と大阪の交渉スタイルの違い、地域補助金、都道府県の規制、方言への配慮
6	組織	organization_check organization_list	系列ネットワーク、企業の階層（部長／課長）、支払い慣習（60 日サイト）、契約慣行
7	外国企業の進出	foreign_entry_check foreign_entry_list	6 つのカテゴリー：会社設立（KK/GK）、経営管理ビザ、銀行口座、不動産、税務登録、従業員の採用
8	旅行	travel_search travel_list	新幹線、IC カード、旅館のマナー、温泉のルール、レストランでの注文、チップの慣習
9	エンターテインメント	entertainment_search entertainment_list	推し活のファン文化、アニメの聖地巡礼、ライブイベントのマナー、季節の祭り
10	日常生活	daily_life_search daily_life_list	郵便・住所の仕組み、自治体ごとのごみ分別、ライフライン（電気／ガス／水道／NHK）、医療機関の利用方法
11	言語	language_search language_list	敬語の仕組み、助数詞、氏名・住所の構成、ビジネス日本語のテンプレート
12	食文化	food_search food_list	食事のマナー、料理の分類、飲食店の利用方法（食券機、居酒屋、寿司カウンター）、食事制限（ハラール、ベジタリアン、アレルギー）
13	災害と安全	disaster_search disaster_list	地震の震度階級と緊急地震速報（EEW）、台風の警戒レベル、緊急連絡先（110／119／118）、防災チェックリスト
14	医療	healthcare_search healthcare_list	国民健康保険、病院の利用方法、処方箋の仕組み、医療用語
15	教育	education_search education_list	学校制度（6-3-3-4）、入学試験、インターナショナルスクール、外国人向け大学入試
16	不動産	real_estate_search real_estate_list	賃貸の手続き（敷金／礼金／保証金）、物件の種類、外国人に対応する不動産会社、契約条件
17	税金	tax_search tax_list	所得税、消費税、源泉徴収、年末調整、外国人や事業者向けの確定申告
18	銀行・金融	banking_search banking_list	銀行口座の種類、送金、フィンテックサービス、法人向け銀行サービス、決済システム
19	ビザ・入国管理	visa_search visa_list	ビザの種類、在留資格、更新手続き、永住権、帰化
20	クロスドメイン	search	1 回のクエリで 20 のドメインすべてを同時に検索

---

スキルパック（MCP Skills Primitive）

ドメインの専門知識、標準業務手順（SOP）、ツールのオーケストレーション手順をまとめた、事前構築済みのナレッジパックです。スキル対応エージェントはこれらを読み込むことで、日本での業務に関する体系的な知識を得られます。

スキルパック	ドメイン	ユースケース
japan-market-entry	regulation, foreign_entry, organization	会社設立、ビザ、銀行取引
japan-business-ops	protocol, calendar, regional, language	会議、根回し、ビジネス日本語
japan-travel-guide	travel, food, entertainment, disaster	旅行者への支援、食事、安全
japan-daily-living	daily_life, food, language	公共料金、ごみ、医療
japan-cultural-context	protocol, organization, language	暗黙のコミュニケーション、階層
japan-safety-compliance	disaster, regulation	地震対応、規制遵守
japan-governance-compliance	regulation, governance	監査証跡、コンプライアンス報告、AI Act への対応準備

→ スキルパックの全ドキュメント

---

ガバナンスインテリジェンス

EDITION には、ガバナンス要件に基づいて運用するエージェント向けのコンプライアンス監査証跡ツールが組み込まれています。プログレッシブディスカバリーとレガシーの両モードで利用できます。

regulation_check → compliance_log → compliance_report
      ↓                   ↓                  ↓
  Check rules      Record audit       Generate report

ツール	目的
compliance_log	規制チェックの実施後に、不変のタイムスタンプ付き監査記録を作成します
compliance_report	監査証跡からガバナンスレポート（概要／詳細／JSON）を生成します

EU AI Act（2026年8月）および今後の日本のAIガバナンスコンプライアンスを想定して設計されています。

---

クイックスタート

オプション 1：npx（Claude Desktop／Cursor に推奨）

npx -y edition-mcp-server

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "edition": {
      "command": "npx",
      "args": ["-y", "edition-mcp-server"],
      "env": {
        "EDITION_API_URL": "https://api.edition.sh",
        "EDITION_API_KEY": "edition_dev_key_for_testing"
      }
    }
  }
}

オプション 2：Smithery

npx -y smithery mcp add hiroshi-c9/edition

オプション 3：REST API（直接利用）

# Cross-domain search
curl -X POST https://api.edition.sh/api/v1/search \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I start a tech company in Tokyo?"}'

# Regulation check
curl -X POST https://api.edition.sh/api/v1/regulation/check \
  -d '{"action": "open restaurant", "industry": "food_service"}'

# Business protocol
curl -X POST https://api.edition.sh/api/v1/protocol/check \
  -d '{"query": "nemawashi consensus building"}'

---

メモリ API — 日本語対応の永続メモリ

エピソードを保存し、敬語の分析、社会的階層の検出、信頼度スコアリングを用いて、構造化された事実を自動抽出します。

Input:  "佐藤部長にはワインをお持ちすれば喜ばれるかと存じます"

Output:
  Subject:    佐藤 (役職: 部長)
  Predicate:  好む
  Object:     ワイン
  Keigo:      Level 2 (尊敬語)
  Hierarchy:  superior
  Confidence: 0.7 (推測 — not stated as fact)
  Tense:      present

3 層アーキテクチャ：

• エピソード — 会話ログの生データ
• 事実 — 構造化された知識（subject→predicate→object のトリプル）
• コンテキスト — エンティティ／トピックごとの、セッションを集約した要約

MCP の機能

カテゴリ	数	詳細
ツール	43	すべてにアノテーション（readOnlyHint、destructiveHint、idempotentHint）があります
リソース	2	edition://domains（ドメインカタログ）、edition://quality（信頼スコア）
プロンプト	2	japan_business_briefing（業種別）、japan_travel_guide（目的地別）

API エンドポイント

メモリ

メソッド	エンドポイント	説明
POST	/api/v1/memory/episodes	エピソードを保存します（事実を自動抽出するには auto_extract=true を指定）
POST	/api/v1/memory/recall	エピソード全体を意味検索します
GET	/api/v1/memory/facts	構造化された事実の一覧を取得します
GET	/api/v1/memory/context	セッションコンテキストの要約を取得します
POST	/api/v1/memory/extract	テキストから事実を抽出します（永続化するには store=true を指定）

規制とコンプライアンス

メソッド	エンドポイント	説明
POST	/api/v1/regulation/check	規制を確認します（10 業種＋旅行者）
GET	/api/v1/regulation/industries	規制対象の全業種を一覧表示します
GET	/api/v1/regulation/tourist	旅行者向け規制カテゴリを取得します

ビジネスインテリジェンス

Method	Endpoint	Description
POST	/api/v1/protocol/check	ビジネスプロトコルを検索
GET	/api/v1/protocol/list	すべてのプロトコルを一覧表示
POST	/api/v1/calendar/check	ビジネスカレンダーを検索
GET	/api/v1/calendar/list	カレンダーのカテゴリを一覧表示
POST	/api/v1/regional/check	地域による違いを検索
GET	/api/v1/regional/list	地域カテゴリを一覧表示
POST	/api/v1/organization/check	組織構造を検索
GET	/api/v1/organization/list	組織カテゴリを一覧表示

市場参入

Method	Endpoint	Description
POST	/api/v1/foreign-entry/check	海外市場への参入ガイド
GET	/api/v1/foreign-entry/list	参入カテゴリを一覧表示（全6件）

ライフスタイルと文化

Method	Endpoint	Description
POST	/api/v1/travel/search	旅行情報
POST	/api/v1/entertainment/search	エンターテインメントとポップカルチャー
POST	/api/v1/daily-life/search	日常生活に関する知識
POST	/api/v1/language/search	日本語
POST	/api/v1/food/search	食文化
POST	/api/v1/disaster/search	災害と安全
POST	/api/v1/healthcare/search	医療制度
POST	/api/v1/education/search	教育制度
POST	/api/v1/real-estate/search	不動産
POST	/api/v1/tax/search	税制
POST	/api/v1/banking/search	銀行と金融
POST	/api/v1/visa/search	ビザと移民

クロスドメイン

Method	Endpoint	Description
POST	/api/v1/search	20の全ドメインを同時に検索

---

データ品質

すべてのナレッジエントリーには、以下が含まれます。

• source_url — 信頼できる情報源（政府機関のウェブサイト、公式団体など）へのリンク
• last_verified — 最終確認日
• confidence — 検証ステータス（verified / estimated）
• version — 変更履歴を含むエントリーのバージョン

情報源には、厚生労働省（MHLW）、国税庁（NTA）、法務省（MOJ）、国土交通省（MLIT）、経済産業省（METI）、日本経団連（Keidanren）、JETRO、入管庁（ISA）が含まれます。

技術スタック

Layer	Technology
API	FastAPI（Python）
Memory Store	SQLite + ChromaDB（ベクトル検索）
MCP Server	TypeScript（MCP SDK v1.12+）
LLM	Gemini / Claude / GPT（ファクト抽出）
Hosting	Render（api.edition.sh）

エージェントの検出

Protocol	Endpoint
MCP（ストリーミング可能な HTTP）	POST https://api.edition.sh/mcp
A2A エージェントカード	GET https://api.edition.sh/.well-known/agent.json
MCP サーバーカード	GET https://api.edition.sh/.well-known/mcp/server-card.json
OpenAPI / Swagger	GET https://api.edition.sh/docs

エージェントハーネス対応

EDITION は、エージェントハーネス向けのツールレジストリ／日本のナレッジレイヤーとして設計されています。43 個のツールすべてに MCP アノテーション（readOnlyHint、destructiveHint、idempotentHint）、使用ガイドライン、動作の透明性に関するメタデータが含まれており、ハーネスフレームワークが手動設定なしで EDITION のツールを自動検出、評価、統合できます。

フリーミアムアクセス

Tier	Domains	Rate Limit	Price
Free	主要な8ドメイン	100 req/day	無料
Pro	20の全ドメイン（税金、銀行、医療、ビザを含む）	10,000 req/day	¥2,980/mo
Enterprise	全ドメイン＋優先サポート	無制限	お問い合わせ

匿名アクセスは、デフォルトで Free ティアになります。POST /api/v1/auth/register から API キーを登録してください。

レジストリ

Registry	Status
npm	✅ 公開済み（v0.4.0）
Smithery	✅ 登録済み（43個のツール）
Glama	✅ グレードAの一貫性評価

なぜ Mem0 / Letta / Zep ではないのですか？

これらは優れた汎用メモリツールです。しかし、次のことはできません。

• 日本語の敬語レベル（丁寧語 / 尊敬語 / 謙譲語）を解析する
• 敬称のパターンから暗黙の社会的な上下関係を検出する
• 日本語の話し方のパターン（断定 vs 推測 vs 伝聞）に基づいて確信度を評価する
• 20のナレッジ領域を含む日本の規制データベースを備える

日本のビジネス環境は構造的に異なります。 エージェントがその環境に対応するには、専用に設計されたインフラストラクチャが必要です。

ライセンス

MIT