Transcode

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)

Key Endpoints (44)

Intelligence — 1コールで全て把握

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

GET /api/v1/briefing

企業インテリジェンス — 6軸分析（プロフィール+財務+株価+開示+保有+マクロ）★

GET /api/v1/intelligence/{ticker}

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

GET /api/v1/market/snapshot

開示統計 — 市場の温度感

GET /api/v1/disclosures/stats

Corporate Data

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

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

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

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

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キャッシュ：

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

Authentication

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

# 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)

Claude Desktop / Cursor Configuration

{

"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

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

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)

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)

# 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)

# English AI summaries + impact scoring for all disclosures

GET /api/v1/disclosures/summarized?days=3&min_impact=3

Returns:

{

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

Telemetry

GET /api/v1/telemetry/today       # Today's API usage stats

GET /api/v1/telemetry/history # Historical usage (7 days default)

Quick Start

# 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

API Documentation

Interactive documentation:

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

License

Proprietary. All rights reserved.