Transcode

Name: Transcode
Author: hiroshic9-png

本地服务

github.com/hiroshic9-png开发工具025 周前更新

代码仓库

关于 Transcode

Transcode 是面向 AI Agent 和市场分析者的日本市场情报 API 平台，整合企业、金融、宏观及环境数据。它通过 MCP 工具与 REST API 提供跨来源分析和数据查询。

主要功能

01跨来源日本市场数据
02企业与股票分析
03宏观经济与政策数据
04天气、地震与经济日历
05AI 解读与披露摘要

适用场景

01生成日本市场每日简报
02分析上市公司及财务表现
03追踪宏观指标与投资者资金流
04评估披露、天气或地震影响

MCP 相关

提供 MCP 服务，向 AI Agent 暴露日本市场情报工具，涵盖简报、公司分析、披露、宏观经济、统计和投资者资金流等。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "japan-intelligence-api": {
      "command": "npx",
      "args": [
        "-y",
        "transcode-mcp-server"
      ],
      "env": {
        "JAPAN_INTELLIGENCE_API_URL": "<JAPAN_INTELLIGENCE_API_URL>",
        "JI_API_KEY": "<JI_API_KEY>"
      }
    }
  }
}

启动命令npx -y transcode-mcp-server

需要配置的环境变量

JAPAN_INTELLIGENCE_API_URLAPI endpoint URL for the TRANSCODE backend (e.g. https://japan-intelligence-api.onrender.com)

JI_API_KEY密钥API key for authentication. Request at https://transcode.sh

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmtranscode-mcp-server1.0.1stdio

工具

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

Japan Intelligence API

面向 AI Agent 的日本市场情报平台

Japan Intelligence 是一个 API 平台，负责将日本公开信息结构化，并以 AI Agent 可立即使用的形式提供。它整合了横跨 14 个数据源的信息，通过 49 个端点 + 27 个 MCP 工具，涵盖企业分析、宏观经济、金融政策和环境灾害。

🎯 一个 API 密钥，获取日本的一切 — 整合提供及时披露、机构投资者持股变动、500 万家法人数据库、10 个政府统计系列、历史股价、日本央行短观、按投资部门划分的交易趋势、日美金融政策、天气预报、地震数据、经济日历和 AI 解读

架构

┌──────────────────────────────────────────────────────────────────┐
│                    AI Agent (Claude, Cursor, etc.)                │
│                          ↓ MCP (22 tools)                        │
│              ┌──────────────────────────────┐                    │
│              │   MCP Server (22 tools)       │                   │
│              └──────────────┬───────────────┘                    │
│                             ↓ REST API (35 endpoints)            │
│  ┌──────────────────────────────────────────────────────────┐    │
│  │              Japan Intelligence API (FastAPI)             │    │
│  │                                                          │    │
│  │  Layer 2: AI Interpretation (Gemini 2.5 Flash)           │    │
│  │  Layer 1: Structured Data + Cache-Control (per-source)   │    │
│  │                                                          │    │
│  │  ┌─────┐ ┌──────┐ ┌────────┐ ┌──────┐ ┌────────┐       │    │
│  │  │TDnet│ │EDINET│ │gBizINFO│ │e-Stat│ │J-Quants│       │    │
│  │  └─────┘ └──────┘ └────────┘ └──────┘ └────────┘       │    │
│  │  ┌────┐ ┌───┐ ┌───┐ ┌─────┐ ┌───────────┐              │    │
│  │  │FRED│ │BOJ│ │JPX│ │Macro│ │Interpreter│               │    │
│  │  └────┘ └───┘ └───┘ └─────┘ └───────────┘              │    │
│  └──────────────────────────────────────────────────────────┘    │
└──────────────────────────────────────────────────────────────────┘

数据源（14）

#	数据源	数据	覆盖范围
1	TDnet	及时披露 — 自动分类为业绩修正、并购、自有股份回购、股息等 15 个类别	所有上市公司
2	EDINET	大量持股报告 — 机构投资者持股变动（超过 5%）	所有上市公司
3	gBizINFO	企业信息 — 补贴、认证、专利、财务、采购	500 万家法人
4	e-Stat	10 个政府统计系列 — GDP、CPI、失业率、工业生产、零售、经济观察员、家庭调查、贸易统计	整体日本经济
5	J-Quants	市场数据 — 所有证券主数据、业绩、财务、历史股价（OHLCV + 移动平均线）、行业分析	所有上市证券
6	FRED	日美宏观数据 — 利率、CPI、就业、汇率、VIX（10 个系列）	美国 + 日本
7	BOJ	日本央行短观 — 企业景气判断 DI（大型/中小型 × 制造业/非制造业 + 资本投资计划）	按季度更新
8	JPX	按投资部门划分的交易趋势 — 外国人、个人、信托银行、事业法人（结构化为 9 个部门）	每周
9	Macro	实时指标 — 原油、黄金、美元兑日元、VIX、日经指数、S&P + 异常波动检测	6 项指标
10	AI	由 Gemini 2.5 Flash 提供结构化数据解读（第 2 层）	所有数据
11	The社史	253 家上市公司的创立至今发展史	主要上市公司
12	Open-Meteo	天气预报（JMA 模型）— 8 个主要城市 + 业务影响判定	东京至那霸
13	USGS	地震数据 — 日本周边 M3+ 地震、行业影响分析、海啸警报	日本全境
14	Calendar	经济日历 — BOJ 会议、短观、GDP、CPI、财报、休市日	2026 年

关键端点（44）

情报 — 一次调用，全面掌握

# 日本全体ブリーフィング（朝の第一手）★ 
GET /api/v1/briefing

# 企業インテリジェンス — 6軸分析（プロフィール+財務+株価+開示+保有+マクロ）★
GET /api/v1/intelligence/{ticker}

# マーケットスナップショット — 市場全体 + 投資部門別フロー + セクター概況
GET /api/v1/market/snapshot

# 開示統計 — 市場の温度感
GET /api/v1/disclosures/stats

企业数据

GET /api/v1/company/{id}              # 企業プロフィール
GET /api/v1/company/{id}/patents      # 特許ポートフォリオ
GET /api/v1/company/{id}/subsidies    # 補助金実績
GET /api/v1/company/{id}/certifications # 認定情報
GET /api/v1/company/{id}/finance      # 財務データ
GET /api/v1/company/search?name=ソニー # 企業名検索
GET /api/v1/disclosures               # 適時開示一覧
GET /api/v1/disclosures/{ticker}      # 銘柄別開示
GET /api/v1/holdings                   # 大量保有報告
GET /api/v1/holdings/{ticker}          # 銘柄別大量保有

市场与财务

GET /api/v1/financials/{ticker}  # 財務サマリー（売上・利益・EPS・予想）
GET /api/v1/stocks               # 全上場銘柄マスタ
GET /api/v1/earnings             # 決算カレンダー
GET /api/v1/prices/{ticker}      # 株価ヒストリカル（OHLCV + MA5/25/75 + 騰落率）★NEW
GET /api/v1/sectors              # セクター分析（17/33業種 + 市場区分別構成）★NEW

政府统计与全球宏观数据

GET /api/v1/stats/series         # 利用可能統計系列一覧
GET /api/v1/stats/summary        # マクロ統計サマリー（1コール）
GET /api/v1/stats/{series_id}    # 個別統計（gdp, cpi, unemployment等10系列）
GET /api/v1/stats/search/{kw}    # 統計検索
GET /api/v1/global/series        # FRED系列一覧
GET /api/v1/global/policy        # 日米金融政策サマリー（1コール）
GET /api/v1/global/{series_key}  # FRED個別系列
GET /api/v1/tankan               # 日銀短観サマリー
GET /api/v1/tankan/{series_id}   # 短観個別系列
GET /api/v1/tankan/series/list   # 短観系列一覧
GET /api/v1/investor-flows       # 投資部門別売買動向（9部門構造化）

宏观数据与事件

GET  /api/v1/macro               # マクロ6指標
GET  /api/v1/macro/events        # 異常変動検知 + 恩恵/逆風銘柄
POST /api/v1/interpret           # AI解釈（Layer 2）
GET  /api/v1/ticker/{ticker}     # 銘柄名解決
GET  /api/v1/health              # ヘルスチェック

环境与灾害

GET /api/v1/weather              # 日本8都市の天気予報（ビジネスインパクト判定付き）
GET /api/v1/weather/cities       # 利用可能な都市一覧
GET /api/v1/earthquakes          # 日本周辺の地震データ（セクター影響分析付き）
GET /api/v1/calendar             # 経済カレンダー（BOJ会合・短観・GDP・CPI・決算・休場日）
GET /api/v1/calendar/holidays    # 東証休場日
GET /api/v1/calendar/categories  # カレンダーカテゴリ一覧

响应缓存

根据数据源特性优化的 HTTP 缓存：

数据源	Cache-Control max-age	原因
TDnet	5 分钟	优先保证实时性
Macro	5 分钟	优先保证实时性
Intelligence	10 分钟	复合数据源
FRED	1 小时	高频访问
e-Stat	6 小时	每月更新
BOJ	6 小时	按季度更新
EDINET	6 小时	每日更新
J-Quants	12 小时	每日更新
JPX	12 小时	每周更新
gBizINFO	24 小时	低频更新

支持 ETag（304 Not Modified）和 stale-while-revalidate。

身份验证

除 /docs、/redoc 和 /health 外，所有端点均需要 API 密钥身份验证：

# Header authentication (recommended)
curl -H "X-API-Key: YOUR_API_KEY" https://japan-intelligence-api.onrender.com/api/v1/briefing

# Bearer token
curl -H "Authorization: Bearer YOUR_API_KEY" https://japan-intelligence-api.onrender.com/api/v1/briefing

# Query parameter
curl "https://japan-intelligence-api.onrender.com/api/v1/briefing?api_key=YOUR_API_KEY"

速率限制：每个 API 密钥 每小时 100 次请求（X-RateLimit-Limit/Remaining 标头）。

MCP 服务（面向 AI Agent 的 27 个工具）

类别	工具	描述
智能分析	`japan_briefing`	🌟 每日简报——市场、政策、短观、情绪、投资者资金流
	`market_snapshot`	市场概览——宏观数据 + 事件 + 信息披露 + 投资者资金流 + 行业
	`company_intelligence`	🌟 跨来源六维公司分析（简介 + 财务 + 股价 + 信息披露 + 持仓 + 宏观数据）
	`disclosure_stats`	信息披露统计——情绪指标
市场	`get_disclosures`	TDnet 企业信息披露及影响评估
	`get_macro`	6 项关键宏观指标（日经指数、USD/JPY、VIX 等）
	`detect_events`	宏观异常检测及股票映射
公司	`company_profile`	gBizINFO 完整公司数据（专利、补贴等）
	`company_search`	搜索 500 多万家公司
	`financials`	J-Quants 财务报表及预测
	`listed_stocks`	所有上市股票主数据
	`earnings_calendar`	即将公布的业绩日期
	`stock_prices`	🆕 股价历史记录，含 MA5/25/75 + 日/周/月变化
	`sector_summary`	🆕 市场结构——17/33 个行业分类 + 市场板块分布
经济	`government_stats`	e-Stat 10 个系列（GDP、CPI、经济观察、贸易等）
	`stats_summary`	宏观统计摘要（1 次调用）
	`global_macro`	FRED 美国 + 日本宏观数据（利率、CPI、外汇、VIX）
	`policy_summary`	美日货币政策摘要（1 次调用）
	`tankan`	BOJ 短观企业情绪 DI
	`investor_flows`	JPX 每周投资者资金流数据（9 个类别，含方向信号）
实用工具	`lookup_ticker`	将股票代码解析为公司名称
	`interpret`	AI 解读（Layer 2，Gemini 2.5）

Claude Desktop / Cursor 配置

{
  "mcpServers": {
    "japan-intelligence": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "JAPAN_INTELLIGENCE_API_URL": "https://japan-intelligence-api.onrender.com",
        "JI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

框架集成（LangChain / CrewAI）

LangChain

from integrations.transcode_langchain import get_transcode_tools
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

tools = get_transcode_tools(api_key="your-api-key")
llm = ChatOpenAI(model="gpt-4o")
agent = create_react_agent(llm, tools)

result = agent.invoke({
    "messages": [("user", "What's happening in Japanese markets today?")]
})

11 个工具：japan_briefing、company_intelligence、market_snapshot、disclosures、ai_summarized_disclosures、holdings、investor_flows、macro_events、tankan_summary、economic_calendar、batch_intelligence

CrewAI

from integrations.transcode_crewai import TranscodeTools
from crewai import Agent, Task, Crew

tools = TranscodeTools(api_key="your-api-key")

analyst = Agent(
    role="Japan Market Analyst",
    goal="Analyze Japanese market conditions and identify opportunities",
    tools=tools.all(),  # 9 tools, or tools.core() for 4 essentials
)

task = Task(
    description="Create a morning briefing on Japanese markets",
    expected_output="Structured market report with key takeaways",
    agent=analyst,
)

crew = Crew(agents=[analyst], tasks=[task])
result = crew.kickoff()

独立使用（无框架）

from integrations.transcode_langchain import TranscodeClient

client = TranscodeClient(api_key="your-api-key")
briefing = client.briefing()
intel = client.intelligence("7203")  # Toyota

批量 API（Developer/Pro）

# Multi-ticker intelligence
POST /api/v1/batch/intelligence   {"tickers": ["7203", "6501", "9984"]}

# Multi-ticker disclosures
POST /api/v1/batch/disclosures    {"tickers": ["7203", "6501"], "days": 3}

# Bulk ticker resolution
POST /api/v1/batch/tickers        {"tickers": ["7203", "6501", "9984"]}

AI 摘要信息披露（独家）

# English AI summaries + impact scoring for all disclosures
GET /api/v1/disclosures/summarized?days=3&min_impact=3

{
  "ai_summary": {
    "summary_en": "Share buyback announced by Toyota, signals undervaluation view",
    "impact_score": 4,
    "sector_relevance": "Automotive, Manufacturing",
    "source": "gemini"
  }
}

遥测

GET /api/v1/telemetry/today       # Today's API usage stats
GET /api/v1/telemetry/history     # Historical usage (7 days default)

快速开始

# 1. Clone
git clone https://github.com/hiroshic9-png/japan-intelligence-api.git
cd japan-intelligence-api

# 2. Setup
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt

# 3. Configure
cp .env.example .env
# Edit .env with your API keys

# 4. Run
python -m api.main
# → http://localhost:8080/docs

环境变量

变量	必填	描述
`EDINET_API_KEY`	是	EDINET 信息披露 API 密钥
`GEMINI_API_KEY`	是	Google Gemini API 密钥（Layer 2 解读）
`GBIZ_API_TOKEN`	是	gBizINFO API 令牌
`ESTAT_APP_ID`	是	e-Stat 应用 ID
`JQUANTS_API_KEY`	是	J-Quants v2 API 密钥
`FRED_API_KEY`	是	FRED API 密钥
`JI_API_KEY`	可选	API 身份验证密钥（设置后启用身份验证）
`JI_API_KEYS`	可选	多级密钥：`{"key": "tier"}`

API 文档

交互式文档：

Swagger UI：https://japan-intelligence-api.onrender.com/docs
ReDoc：https://japan-intelligence-api.onrender.com/redoc

许可证

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。