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

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

# 企業インテリジェンス — 6軸分析（プロフィール+財務+株価+開示+保有+マクロ）★
GET /api/v1/intelligence/{ticker}

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

# 開示統計 — 市場の温度感
GET /api/v1/disclosures/stats

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

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

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

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

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

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

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

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?")]
})

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

from integrations.transcode_langchain import TranscodeClient

client = TranscodeClient(api_key="your-api-key")
briefing = client.briefing()
intel = client.intelligence("7203")  # Toyota

# Multi-ticker intelligence
POST /api/v1/batch/intelligence   {"tickers": ["7203", "6501", "9984"]}