io.github.hiroshic9-png/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.