Transcode

io.github.hiroshic9-png由 GitHub 账号 hiroshic9-png 发布v1.0.1更新于 Oct 24, 2026

Japan market intelligence — 22 MCP tools, 10 government/exchange data sources

已验证STDIO仅桌面网页搜索与抓取金融数据与分析

概览

AI 生成的概览

为助手提供 22 个日本市场情报工具，涵盖信息披露、企业数据、政府统计、宏观指标、天气与地震。

可以做什么
该服务器提供 japan_briefing、company_intelligence、market_snapshot、get_disclosures、financials、stock_prices、government_stats、tankan、investor_flows、interpret 等工具。它把日本公开数据——TDnet 适时披露、EDINET 大量持有报告、gBizINFO 企业信息、e-Stat 政府统计、J-Quants 市场数据、FRED、日本银行短观、JPX 投资部门别买卖动向、天气与地震数据——整合为结构化结果，并附带 AI 解读层。它本身是调用托管 REST 后端的轻量客户端。
适用场景
适合需要日本股票、企业或宏观经济背景的场景：每日市场简报、跨来源企业分析、披露监控、宏观与政策摘要。不适用于日本以外市场或所列来源之外的数据。
运行要求
以 npm 包 transcode-mcp-server 通过 stdio 在本地运行，需要 Node.js。需要环境变量 JAPAN_INTELLIGENCE_API_URL（后端地址）和 JI_API_KEY（密钥，需在 transcode.sh 申请）。需要访问后端网络；后端按密钥限制每小时 100 次请求。
安装前请注意
JI_API_KEY 密钥会发送给托管后端，所有查询与结果都经过该第三方。若自行部署后端，还需其上游凭据（EDINET_API_KEY、GEMINI_API_KEY、GBIZ_API_TOKEN、ESTAT_APP_ID、JQUANTS_API_KEY、FRED_API_KEY）。工具均为只读查询，但 interpret 会把数据发送给基于 Gemini 的解读层。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Transcode，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Japan Intelligence API

AIエージェントのための日本市場インテリジェンス基盤

Japan Intelligence は、日本の公開情報を構造化し、AIエージェントが即座に利用可能な形式で提供するAPIプラットフォームです。14のデータソースを横断統合し、企業分析・マクロ経済・金融政策・環境災害を49エンドポイント + 27 MCPツールで完結させます。

🎯 1つのAPIキーで日本の全て — 適時開示、機関投資家の持分変動、500万法人のデータベース、政府統計10系列、株価ヒストリカル、日銀短観、投資部門別売買動向、日米金融政策、天気予報、地震データ、経済カレンダー、AI解釈を統合提供

Architecture

┌──────────────────────────────────────────────────────────────────┐│                    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│               │    ││  │  └────┘ └───┘ └───┘ └─────┘ └───────────┘              │    ││  └──────────────────────────────────────────────────────────┘    │└──────────────────────────────────────────────────────────────────┘

Data Sources (14)

#SourceDataCoverage
1TDnet適時開示 — 業績修正、M&A、自社株買い、配当等15カテゴリ自動分類全上場企業
2EDINET大量保有報告書 — 機関投資家の持分変動（5%超）全上場企業
3gBizINFO企業情報 — 補助金、認定、特許、財務、調達500万法人
4e-Stat政府統計10系列 — GDP、CPI、失業率、鉱工業生産、小売、景気ウォッチャー、家計調査、貿易統計日本経済全体
5J-Quants市場データ — 全銘柄マスタ、決算、財務、株価ヒストリカル（OHLCV + 移動平均）、セクター分析全上場銘柄
6FRED日米マクロ — 金利、CPI、雇用、為替、VIX（10系列）米国+日本
7BOJ日銀短観 — 業況判断DI（大企業/中小×製造業/非製造業＋設備投資計画）四半期更新
8JPX投資部門別売買動向 — 外国人、個人、信託銀行、事業法人（9部門構造化）週次
9Macroリアルタイム指標 — 原油、金、ドル円、VIX、日経、S&P + 異常変動検知6指標
10AIGemini 2.5 Flash による構造化データ解釈（Layer 2）全データ
11The社史上場企業253社の創業〜現在の社歴主要上場企業
12Open-Meteo天気予報（JMAモデル） — 8主要都市 + ビジネスインパクト判定東京〜那覇
13USGS地震データ — 日本周辺M3+、セクター影響分析、津波警報日本全域
14Calendar経済カレンダー — BOJ会合、短観、GDP、CPI、決算、休場日2026年

Key Endpoints (44)

Intelligence — 1コールで全て把握

bash
# 日本全体ブリーフィング（朝の第一手）★ GET /api/v1/briefing
# 企業インテリジェンス — 6軸分析（プロフィール+財務+株価+開示+保有+マクロ）★GET /api/v1/intelligence/{ticker}
# マーケットスナップショット — 市場全体 + 投資部門別フロー + セクター概況GET /api/v1/market/snapshot
# 開示統計 — 市場の温度感GET /api/v1/disclosures/stats

Corporate Data

bash
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}          # 銘柄別大量保有

Market & Financials

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

Government Statistics & Global Macro

bash
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部門構造化）

Macro & Events

bash
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              # ヘルスチェック

Environment & Disaster

bash
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  # カレンダーカテゴリ一覧

Response Caching

ソース特性別に最適化されたHTTPキャッシュ：

SourceCache-Control max-age理由
TDnet5分リアルタイム性重視
Macro5分リアルタイム性重視
Intelligence10分複合ソース
FRED1時間高頻度参照
e-Stat6時間月次更新
BOJ6時間四半期更新
EDINET6時間日次更新
J-Quants12時間日次更新
JPX12時間週次更新
gBizINFO24時間低頻度更新

ETag対応（304 Not Modified）、stale-while-revalidate対応。

Authentication

All endpoints (except /docs, /redoc, /health) require API key authentication:

bash
# Header authentication (recommended)curl -H "X-API-Key: YOUR_API_KEY" https://japan-intelligence-api.onrender.com/api/v1/briefing
# Bearer tokencurl -H "Authorization: Bearer YOUR_API_KEY" https://japan-intelligence-api.onrender.com/api/v1/briefing
# Query parametercurl "https://japan-intelligence-api.onrender.com/api/v1/briefing?api_key=YOUR_API_KEY"

Rate limit: 100 requests/hour per API key (X-RateLimit-Limit/Remaining headers).

MCP Server (27 tools for AI Agents)

CategoryToolDescription
Intelligencejapan_briefing🌟 Daily briefing — market, policy, tankan, sentiment, investor flows
market_snapshotMarket overview — macro + events + disclosures + investor flows + sectors
company_intelligence🌟 Cross-source 6-axis company analysis (profile + financials + stock price + disclosures + holdings + macro)
disclosure_statsDisclosure statistics — sentiment gauge
Marketget_disclosuresTDnet corporate disclosures with impact assessment
get_macro6 key macro indicators (Nikkei, USD/JPY, VIX, etc.)
detect_eventsMacro anomaly detection with stock mapping
Companycompany_profilegBizINFO full company data (patents, subsidies, etc.)
company_searchSearch 5M+ corporations
financialsJ-Quants financial statements with forecasts
listed_stocksAll listed stocks master
earnings_calendarUpcoming earnings dates
stock_prices🆕 Stock price history with MA5/25/75 + daily/weekly/monthly changes
sector_summary🆕 Market structure — 17/33 sector classifications + market segment distribution
Economicsgovernment_statse-Stat 10 series (GDP, CPI, economy watchers, trade, etc.)
stats_summaryMacro statistics summary (1 call)
global_macroFRED US + Japan macro (rates, CPI, FX, VIX)
policy_summaryUS-Japan monetary policy summary (1 call)
tankanBOJ Tankan business sentiment DI
investor_flowsJPX weekly investor flow data (9 categories with directional signals)
Utilitylookup_tickerTicker → company name resolution
interpretAI interpretation (Layer 2, Gemini 2.5)

Claude Desktop / Cursor Configuration

json
{  "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"      }    }  }}

Framework Integration (LangChain / CrewAI)

LangChain

python
from integrations.transcode_langchain import get_transcode_toolsfrom langchain_openai import ChatOpenAIfrom 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 tools: japan_briefing, company_intelligence, market_snapshot, disclosures, ai_summarized_disclosures, holdings, investor_flows, macro_events, tankan_summary, economic_calendar, batch_intelligence

CrewAI

python
from integrations.transcode_crewai import TranscodeToolsfrom 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()

Standalone (No Framework)

python
from integrations.transcode_langchain import TranscodeClient
client = TranscodeClient(api_key="your-api-key")briefing = client.briefing()intel = client.intelligence("7203")  # Toyota

Batch API (Developer/Pro)

bash
# Multi-ticker intelligencePOST /api/v1/batch/intelligence   {"tickers": ["7203", "6501", "9984"]}
# Multi-ticker disclosuresPOST /api/v1/batch/disclosures    {"tickers": ["7203", "6501"], "days": 3}
# Bulk ticker resolutionPOST /api/v1/batch/tickers        {"tickers": ["7203", "6501", "9984"]}

AI-Summarized Disclosures (Exclusive)

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

Returns:

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

Telemetry

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

Quick Start

bash
# 1. Clonegit clone https://github.com/hiroshic9-png/japan-intelligence-api.gitcd japan-intelligence-api
# 2. Setuppython -m venv venv && source venv/bin/activatepip install -r requirements.txt
# 3. Configurecp .env.example .env# Edit .env with your API keys
# 4. Runpython -m api.main# → http://localhost:8080/docs

Environment Variables

VariableRequiredDescription
EDINET_API_KEYYesEDINET disclosure API key
GEMINI_API_KEYYesGoogle Gemini API key (Layer 2 interpretation)
GBIZ_API_TOKENYesgBizINFO API token
ESTAT_APP_IDYese-Stat application ID
JQUANTS_API_KEYYesJ-Quants v2 API key
FRED_API_KEYYesFRED API key
JI_API_KEYOptionalAPI authentication key (enables auth when set)
JI_API_KEYSOptionalMulti-tier keys: {"key": "tier"}

API Documentation

Interactive documentation:

License

Proprietary. All rights reserved.

来源：README.md，提交 54d761c

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。