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 分

    請在儲存庫或註冊中心條目中宣告授權條款。