io.github.hiroshic9-png/transcode

Official

by hiroshic9-png · Python

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

Access Japanese market data from 10 government and exchange sources.

README.md15 KBView on GitHub

Japan Intelligence API

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

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

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

Architecture

code

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

#	Source	Data	Coverage
1	TDnet	適時開示 — 業績修正、M&A、自社株買い、配当等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 による構造化データ解釈（Layer 2）	全データ
11	The社史	上場企業253社の創業〜現在の社歴	主要上場企業
12	Open-Meteo	天気予報（JMAモデル） — 8主要都市 + ビジネスインパクト判定	東京〜那覇
13	USGS	地震データ — 日本周辺M3+、セクター影響分析、津波警報	日本全域
14	Calendar	経済カレンダー — 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 + 騰落率）★NEW
GET /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キャッシュ：

Source	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対応。

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

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

MCP Server (27 tools for AI Agents)

Category	Tool	Description
Intelligence	`japan_briefing`	🌟 Daily briefing — market, policy, tankan, sentiment, investor flows
	`market_snapshot`	Market overview — macro + events + disclosures + investor flows + sectors
	`company_intelligence`	🌟 Cross-source 6-axis company analysis (profile + financials + stock price + disclosures + holdings + macro)
	`disclosure_stats`	Disclosure statistics — sentiment gauge
Market	`get_disclosures`	TDnet corporate disclosures with impact assessment
	`get_macro`	6 key macro indicators (Nikkei, USD/JPY, VIX, etc.)
	`detect_events`	Macro anomaly detection with stock mapping
Company	`company_profile`	gBizINFO full company data (patents, subsidies, etc.)
	`company_search`	Search 5M+ corporations
	`financials`	J-Quants financial statements with forecasts
	`listed_stocks`	All listed stocks master
	`earnings_calendar`	Upcoming 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
Economics	`government_stats`	e-Stat 10 series (GDP, CPI, economy watchers, trade, etc.)
	`stats_summary`	Macro statistics summary (1 call)
	`global_macro`	FRED US + Japan macro (rates, CPI, FX, VIX)
	`policy_summary`	US-Japan monetary policy summary (1 call)
	`tankan`	BOJ Tankan business sentiment DI
	`investor_flows`	JPX weekly investor flow data (9 categories with directional signals)
Utility	`lookup_ticker`	Ticker → company name resolution
	`interpret`	AI 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_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 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 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()

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 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-Summarized Disclosures (Exclusive)

bash

# English AI summaries + impact scoring for all disclosures
GET /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 stats
GET /api/v1/telemetry/history     # Historical usage (7 days default)

Quick Start

bash

# 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

Environment Variables

Variable	Required	Description
`EDINET_API_KEY`	Yes	EDINET disclosure API key
`GEMINI_API_KEY`	Yes	Google Gemini API key (Layer 2 interpretation)
`GBIZ_API_TOKEN`	Yes	gBizINFO API token
`ESTAT_APP_ID`	Yes	e-Stat application ID
`JQUANTS_API_KEY`	Yes	J-Quants v2 API key
`FRED_API_KEY`	Yes	FRED API key
`JI_API_KEY`	Optional	API authentication key (enables auth when set)
`JI_API_KEYS`	Optional	Multi-tier keys: `{"key": "tier"}`

API Documentation

Interactive documentation:

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

License

Install

Configuration

Environment variables

JAPAN_INTELLIGENCE_API_URLrequired

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

JI_API_KEYrequiredsecret

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

claude_desktop_config.json

{
  "mcpServers": {
    "transcode": {
      "command": "npx",
      "args": [
        "-y",
        "transcode-mcp-server@1.0.1"
      ],
      "env": {
        "JAPAN_INTELLIGENCE_API_URL": "<YOUR_JAPAN_INTELLIGENCE_API_URL>",
        "JI_API_KEY": "<YOUR_JI_API_KEY>"
      }
    }
  }
}