edition-api

EDITION Intelligence Platform

为自主 AI Agent 提供的日本知识门户。

20 个知识领域 · 43 个 MCP 工具 · 7 个技能包 · 100+ 个 REST 端点 在日本市场开展业务所需的可信事实依据。质量评分：97.8/100。

生产环境 API： api.edition.sh — 免费 Beta 版，无需注册。

交互式演示： Tourist Agent Demo — 观看 6 个领域实时协同工作。

---

为什么选择 EDITION？

在日本开展工作的 AI Agent 会遇到通用大模型无法解决的障碍：

挑战	问题所在
敬语（敬語）	「お持ちすれば喜ばれるかと存じます」——隐含主语、多层敬语和不确定性表达。通用 NLP 会将这些视为噪声。
隐含约定	日本商务沟通很少直截了当地表达。Agent 需要解读文化语境。
监管迷宫	10 多个行业受到相互重叠的国家和都道府县法规约束，大多数文档只有日语版本。
流程复杂	公司设立、签证、银行业务——每项都需要 5-8 个步骤，并准备特定文件、留意截止日期和费用。

EDITION 提供经过验证的结构化情报，让 Agent 能将其用作事实依据，而不是凭空编造文化细微差别、法律要求和流程细节。

---

20 个知识领域

#	领域	工具	涵盖内容
1	记忆	memory_store memory_recall memory_facts memory_context memory_extract	三层持久化记忆（事件/事实/上下文），包含日语敬语分析和社会等级检测
2	法规	regulation_check regulation_industries regulation_tourist	10 个行业（食品、房地产、金融、医疗保健、建筑、教育、交通、零售、IT、制造业）以及游客合规事项
3	礼仪规范	protocol_check protocol_list	Nemawashi、ringi、hourensou、meishi koukan、sekijun、zoutou——结合文化背景的分步流程
4	日历	calendar_check calendar_list	财年（4 月开始）、黄金周、盂兰盆节、年末、送礼时节、行政截止日期
5	地区	regional_check regional_list	东京与大阪的谈判风格、地方补贴、都道府县法规、方言注意事项
6	组织	organization_check organization_list	企业集团网络、企业层级（部长/课长）、付款习惯（net-60）、合同惯例
7	外国企业入驻	foreign_entry_check foreign_entry_list	6 个类别：公司设立（KK/GK）、经营管理签证、银行账户、房地产、税务登记、员工招聘
8	旅行	travel_search travel_list	新干线、IC 卡、日式旅馆礼仪、温泉规定、餐厅点餐、小费习惯
9	娱乐	entertainment_search entertainment_list	Oshi-katsu 粉丝文化、动漫圣地巡礼、现场活动礼仪、季节性节庆
10	日常生活	daily_life_search daily_life_list	邮政/地址系统、按市町村分类垃圾、公用事业（电力/燃气/水费/NHK）、就医指南
11	语言	language_search language_list	敬语系统、量词（josushi）、姓名/地址结构、商务日语模板
12	饮食文化	food_search food_list	用餐礼仪、料理分类、餐厅点餐指南（shokkenki、居酒屋、寿司吧台）、饮食限制（清真、素食、过敏）
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	租房流程（shikikin/reikin/hoshoukin）、房产类型、对外国人友好的中介、合同条款
17	税务	tax_search tax_list	所得税、消费税、预扣税、年末调整、外国人和企业报税
18	银行与金融	banking_search banking_list	银行账户类型、汇款、金融科技服务、企业银行业务、支付系统
19	签证与移民	visa_search visa_list	签证类别、在留资格、续签手续、永久居留、归化
20	跨领域	search	通过单次查询同时搜索全部 20 个领域

---

技能包（MCP 技能原语）

预构建的知识包，整合领域专业知识、标准作业流程和工具编排说明。支持技能的 Agent 可加载这些知识包，以获取结构化的日本运营知识。

技能包	领域	使用场景
japan-market-entry	监管、外资进入、组织	公司注册、签证、银行业务
japan-business-ops	礼仪、日历、地区、语言	会议、nemawashi、商务日语
japan-travel-guide	旅行、饮食、娱乐、灾害	游客协助、用餐、安全
japan-daily-living	日常生活、饮食、语言	公用事业、垃圾处理、医疗保健
japan-cultural-context	礼仪、组织、语言	隐性沟通、层级关系
japan-safety-compliance	灾害、监管	地震应对、法规合规
japan-governance-compliance	监管、治理	审计轨迹、合规报告、AI Act 准备工作

→ 完整的技能包文档

---

治理智能

EDITION 内置合规审计轨迹工具，供在治理要求下运行的 Agent 使用。渐进式发现模式和传统模式均可使用。

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"}'

---

Memory API — 支持日语的持久化记忆

存储事件，并自动提取结构化事实，同时进行敬语分析、社会层级检测和置信度评分。

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

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

三层架构：

• 事件 — 原始对话日志
• 事实 — 结构化知识（主语→谓语→宾语三元组）
• 上下文 — 按实体／主题汇总的会话摘要

MCP 功能

类别	数量	详情
工具	43	均带有注释（readOnlyHint、destructiveHint、idempotentHint）
资源	2	edition://domains（领域目录）、edition://quality（可信度评分）
提示词	2	japan_business_briefing（按行业）、japan_travel_guide（按目的地）

API 端点

Memory

方法	端点	说明
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	旅游法规类别

商业智能

方法	端点	描述
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	列出组织类别

市场进入

方法	端点	描述
POST	/api/v1/foreign-entry/check	海外市场进入指南
GET	/api/v1/foreign-entry/list	列出进入类别（共 6 个）

生活方式与文化

方法	端点	描述
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	签证与移民

跨领域

方法	端点	描述
POST	/api/v1/search	同时搜索全部 20 个领域

---

数据质量

所有知识条目均包含：

• source_url — 指向权威来源的链接（政府网站、官方组织）
• last_verified — 上次验证日期
• confidence — 验证状态（verified / estimated）
• version — 条目版本及变更日志

来源包括：厚生労働省（MHLW）、国税庁（NTA）、法務省（MOJ）、国土交通省（MLIT）、経済産業省（METI）、日本経団連（Keidanren）、JETRO、入管庁（ISA）。

技术栈

层	技术
API	FastAPI (Python)
内存存储	SQLite + ChromaDB（向量搜索）
MCP 服务	TypeScript（MCP SDK v1.12+）
大模型	Gemini / Claude / GPT（事实提取）
托管	Render (api.edition.sh)

Agent 发现

协议	端点
MCP（Streamable HTTP）	POST https://api.edition.sh/mcp
A2A Agent Card	GET https://api.edition.sh/.well-known/agent.json
MCP Server Card	GET https://api.edition.sh/.well-known/mcp/server-card.json
OpenAPI / Swagger	GET https://api.edition.sh/docs

兼容 Agent Harness

EDITION 专为 Agent Harness 打造，作为工具注册表 / 日本知识层。全部 43 个工具均包含 MCP 注解（readOnlyHint、destructiveHint、idempotentHint）、使用指南和行为透明度元数据，使 Harness 框架能够自动发现、评估和集成 EDITION 工具，无需手动配置。

免费增值访问

套餐	领域	速率限制	价格
免费版	8 个核心领域	100 次请求/天	免费
专业版	全部 20 个领域（包括税收、银行、医疗保健、签证）	10,000 次请求/天	¥2,980/月
企业版	全部领域 + 优先支持	不限量	联系我们

匿名访问默认使用免费版套餐。通过 POST /api/v1/auth/register 注册并获取 API 密钥。

注册平台

注册平台	状态
npm	✅ 已发布（v0.4.0）
Smithery	✅ 已收录（43 个工具）
Glama	✅ A 级一致性

为什么不选 Mem0 / Letta / Zep？

这些都是出色的通用记忆工具。但它们无法：

• 解析日语敬语级别（丁寧語 / 尊敬語 / 謙譲語）
• 根据敬称模式检测隐含的社会层级
• 根据日语表达模式（断定 vs 推测 vs 传闻）评估置信度
• 提供包含 20 个知识领域的日本监管数据库

日本商业环境的结构截然不同。 Agent 需要专门构建的基础设施来应对其中的复杂情况。

许可证

MIT