{
  "markdown": "# Japan Intelligence API\n\n**AIエージェントのための日本市場インテリジェンス基盤**\n\nJapan Intelligence は、日本の公開情報を構造化し、AIエージェントが即座に利用可能な形式で提供するAPIプラットフォームです。**14のデータソース**を横断統合し、企業分析・マクロ経済・金融政策・環境災害を**49エンドポイント + 27 MCPツール**で完結させます。\n\n> 🎯 **1つのAPIキーで日本の全て** — 適時開示、機関投資家の持分変動、500万法人のデータベース、政府統計10系列、株価ヒストリカル、日銀短観、投資部門別売買動向、日米金融政策、天気予報、地震データ、経済カレンダー、AI解釈を統合提供\n\n---\n\n## Architecture\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│                    AI Agent (Claude, Cursor, etc.)                │\n│                          ↓ MCP (22 tools)                        │\n│              ┌──────────────────────────────┐                    │\n│              │   MCP Server (22 tools)       │                   │\n│              └──────────────┬───────────────┘                    │\n│                             ↓ REST API (35 endpoints)            │\n│  ┌──────────────────────────────────────────────────────────┐    │\n│  │              Japan Intelligence API (FastAPI)             │    │\n│  │                                                          │    │\n│  │  Layer 2: AI Interpretation (Gemini 2.5 Flash)           │    │\n│  │  Layer 1: Structured Data + Cache-Control (per-source)   │    │\n│  │                                                          │    │\n│  │  ┌─────┐ ┌──────┐ ┌────────┐ ┌──────┐ ┌────────┐       │    │\n│  │  │TDnet│ │EDINET│ │gBizINFO│ │e-Stat│ │J-Quants│       │    │\n│  │  └─────┘ └──────┘ └────────┘ └──────┘ └────────┘       │    │\n│  │  ┌────┐ ┌───┐ ┌───┐ ┌─────┐ ┌───────────┐              │    │\n│  │  │FRED│ │BOJ│ │JPX│ │Macro│ │Interpreter│               │    │\n│  │  └────┘ └───┘ └───┘ └─────┘ └───────────┘              │    │\n│  └──────────────────────────────────────────────────────────┘    │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n## Data Sources (14)\n\n| # | Source | Data | Coverage |\n|---|--------|------|----------|\n| 1 | **TDnet** | 適時開示 — 業績修正、M&A、自社株買い、配当等15カテゴリ自動分類 | 全上場企業 |\n| 2 | **EDINET** | 大量保有報告書 — 機関投資家の持分変動（5%超） | 全上場企業 |\n| 3 | **gBizINFO** | 企業情報 — 補助金、認定、特許、財務、調達 | 500万法人 |\n| 4 | **e-Stat** | 政府統計10系列 — GDP、CPI、失業率、鉱工業生産、小売、景気ウォッチャー、家計調査、貿易統計 | 日本経済全体 |\n| 5 | **J-Quants** | 市場データ — 全銘柄マスタ、決算、財務、株価ヒストリカル（OHLCV + 移動平均）、セクター分析 | 全上場銘柄 |\n| 6 | **FRED** | 日米マクロ — 金利、CPI、雇用、為替、VIX（10系列） | 米国+日本 |\n| 7 | **BOJ** | 日銀短観 — 業況判断DI（大企業/中小×製造業/非製造業＋設備投資計画） | 四半期更新 |\n| 8 | **JPX** | 投資部門別売買動向 — 外国人、個人、信託銀行、事業法人（9部門構造化） | 週次 |\n| 9 | **Macro** | リアルタイム指標 — 原油、金、ドル円、VIX、日経、S&P + 異常変動検知 | 6指標 |\n| 10 | **AI** | Gemini 2.5 Flash による構造化データ解釈（Layer 2） | 全データ |\n| 11 | **The社史** | 上場企業253社の創業〜現在の社歴 | 主要上場企業 |\n| 12 | **Open-Meteo** | 天気予報（JMAモデル） — 8主要都市 + ビジネスインパクト判定 | 東京〜那覇 |\n| 13 | **USGS** | 地震データ — 日本周辺M3+、セクター影響分析、津波警報 | 日本全域 |\n| 14 | **Calendar** | 経済カレンダー — BOJ会合、短観、GDP、CPI、決算、休場日 | 2026年 |\n\n## Key Endpoints (44)\n\n### Intelligence — 1コールで全て把握\n\n```bash\n# 日本全体ブリーフィング（朝の第一手）★ \nGET /api/v1/briefing\n\n# 企業インテリジェンス — 6軸分析（プロフィール+財務+株価+開示+保有+マクロ）★\nGET /api/v1/intelligence/{ticker}\n\n# マーケットスナップショット — 市場全体 + 投資部門別フロー + セクター概況\nGET /api/v1/market/snapshot\n\n# 開示統計 — 市場の温度感\nGET /api/v1/disclosures/stats\n```\n\n### Corporate Data\n\n```bash\nGET /api/v1/company/{id}              # 企業プロフィール\nGET /api/v1/company/{id}/patents      # 特許ポートフォリオ\nGET /api/v1/company/{id}/subsidies    # 補助金実績\nGET /api/v1/company/{id}/certifications # 認定情報\nGET /api/v1/company/{id}/finance      # 財務データ\nGET /api/v1/company/search?name=ソニー # 企業名検索\nGET /api/v1/disclosures               # 適時開示一覧\nGET /api/v1/disclosures/{ticker}      # 銘柄別開示\nGET /api/v1/holdings                   # 大量保有報告\nGET /api/v1/holdings/{ticker}          # 銘柄別大量保有\n```\n\n### Market & Financials\n\n```bash\nGET /api/v1/financials/{ticker}  # 財務サマリー（売上・利益・EPS・予想）\nGET /api/v1/stocks               # 全上場銘柄マスタ\nGET /api/v1/earnings             # 決算カレンダー\nGET /api/v1/prices/{ticker}      # 株価ヒストリカル（OHLCV + MA5/25/75 + 騰落率）★NEW\nGET /api/v1/sectors              # セクター分析（17/33業種 + 市場区分別構成）★NEW\n```\n\n### Government Statistics & Global Macro\n\n```bash\nGET /api/v1/stats/series         # 利用可能統計系列一覧\nGET /api/v1/stats/summary        # マクロ統計サマリー（1コール）\nGET /api/v1/stats/{series_id}    # 個別統計（gdp, cpi, unemployment等10系列）\nGET /api/v1/stats/search/{kw}    # 統計検索\nGET /api/v1/global/series        # FRED系列一覧\nGET /api/v1/global/policy        # 日米金融政策サマリー（1コール）\nGET /api/v1/global/{series_key}  # FRED個別系列\nGET /api/v1/tankan               # 日銀短観サマリー\nGET /api/v1/tankan/{series_id}   # 短観個別系列\nGET /api/v1/tankan/series/list   # 短観系列一覧\nGET /api/v1/investor-flows       # 投資部門別売買動向（9部門構造化）\n```\n\n### Macro & Events\n\n```bash\nGET  /api/v1/macro               # マクロ6指標\nGET  /api/v1/macro/events        # 異常変動検知 + 恩恵/逆風銘柄\nPOST /api/v1/interpret           # AI解釈（Layer 2）\nGET  /api/v1/ticker/{ticker}     # 銘柄名解決\nGET  /api/v1/health              # ヘルスチェック\n```\n\n### Environment & Disaster\n\n```bash\nGET /api/v1/weather              # 日本8都市の天気予報（ビジネスインパクト判定付き）\nGET /api/v1/weather/cities       # 利用可能な都市一覧\nGET /api/v1/earthquakes          # 日本周辺の地震データ（セクター影響分析付き）\nGET /api/v1/calendar             # 経済カレンダー（BOJ会合・短観・GDP・CPI・決算・休場日）\nGET /api/v1/calendar/holidays    # 東証休場日\nGET /api/v1/calendar/categories  # カレンダーカテゴリ一覧\n```\n\n## Response Caching\n\nソース特性別に最適化されたHTTPキャッシュ：\n\n| Source | Cache-Control max-age | 理由 |\n|--------|----------------------|------|\n| TDnet | 5分 | リアルタイム性重視 |\n| Macro | 5分 | リアルタイム性重視 |\n| Intelligence | 10分 | 複合ソース |\n| FRED | 1時間 | 高頻度参照 |\n| e-Stat | 6時間 | 月次更新 |\n| BOJ | 6時間 | 四半期更新 |\n| EDINET | 6時間 | 日次更新 |\n| J-Quants | 12時間 | 日次更新 |\n| JPX | 12時間 | 週次更新 |\n| gBizINFO | 24時間 | 低頻度更新 |\n\nETag対応（304 Not Modified）、stale-while-revalidate対応。\n\n## Authentication\n\nAll endpoints (except `/docs`, `/redoc`, `/health`) require API key authentication:\n\n```bash\n# Header authentication (recommended)\ncurl -H \"X-API-Key: YOUR_API_KEY\" https://japan-intelligence-api.onrender.com/api/v1/briefing\n\n# Bearer token\ncurl -H \"Authorization: Bearer YOUR_API_KEY\" https://japan-intelligence-api.onrender.com/api/v1/briefing\n\n# Query parameter\ncurl \"https://japan-intelligence-api.onrender.com/api/v1/briefing?api_key=YOUR_API_KEY\"\n```\n\nRate limit: **100 requests/hour** per API key (X-RateLimit-Limit/Remaining headers).\n\n## MCP Server (27 tools for AI Agents)\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| **Intelligence** | `japan_briefing` | 🌟 Daily briefing — market, policy, tankan, sentiment, investor flows |\n| | `market_snapshot` | Market overview — macro + events + disclosures + investor flows + sectors |\n| | `company_intelligence` | 🌟 Cross-source 6-axis company analysis (profile + financials + stock price + disclosures + holdings + macro) |\n| | `disclosure_stats` | Disclosure statistics — sentiment gauge |\n| **Market** | `get_disclosures` | TDnet corporate disclosures with impact assessment |\n| | `get_macro` | 6 key macro indicators (Nikkei, USD/JPY, VIX, etc.) |\n| | `detect_events` | Macro anomaly detection with stock mapping |\n| **Company** | `company_profile` | gBizINFO full company data (patents, subsidies, etc.) |\n| | `company_search` | Search 5M+ corporations |\n| | `financials` | J-Quants financial statements with forecasts |\n| | `listed_stocks` | All listed stocks master |\n| | `earnings_calendar` | Upcoming earnings dates |\n| | `stock_prices` | 🆕 Stock price history with MA5/25/75 + daily/weekly/monthly changes |\n| | `sector_summary` | 🆕 Market structure — 17/33 sector classifications + market segment distribution |\n| **Economics** | `government_stats` | e-Stat 10 series (GDP, CPI, economy watchers, trade, etc.) |\n| | `stats_summary` | Macro statistics summary (1 call) |\n| | `global_macro` | FRED US + Japan macro (rates, CPI, FX, VIX) |\n| | `policy_summary` | US-Japan monetary policy summary (1 call) |\n| | `tankan` | BOJ Tankan business sentiment DI |\n| | `investor_flows` | JPX weekly investor flow data (9 categories with directional signals) |\n| **Utility** | `lookup_ticker` | Ticker → company name resolution |\n| | `interpret` | AI interpretation (Layer 2, Gemini 2.5) |\n\n### Claude Desktop / Cursor Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"japan-intelligence\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/mcp-server/dist/index.js\"],\n      \"env\": {\n        \"JAPAN_INTELLIGENCE_API_URL\": \"https://japan-intelligence-api.onrender.com\",\n        \"JI_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n## Framework Integration (LangChain / CrewAI)\n\n### LangChain\n\n```python\nfrom integrations.transcode_langchain import get_transcode_tools\nfrom langchain_openai import ChatOpenAI\nfrom langgraph.prebuilt import create_react_agent\n\ntools = get_transcode_tools(api_key=\"your-api-key\")\nllm = ChatOpenAI(model=\"gpt-4o\")\nagent = create_react_agent(llm, tools)\n\nresult = agent.invoke({\n    \"messages\": [(\"user\", \"What's happening in Japanese markets today?\")]\n})\n```\n\n11 tools: `japan_briefing`, `company_intelligence`, `market_snapshot`, `disclosures`, `ai_summarized_disclosures`, `holdings`, `investor_flows`, `macro_events`, `tankan_summary`, `economic_calendar`, `batch_intelligence`\n\n### CrewAI\n\n```python\nfrom integrations.transcode_crewai import TranscodeTools\nfrom crewai import Agent, Task, Crew\n\ntools = TranscodeTools(api_key=\"your-api-key\")\n\nanalyst = Agent(\n    role=\"Japan Market Analyst\",\n    goal=\"Analyze Japanese market conditions and identify opportunities\",\n    tools=tools.all(),  # 9 tools, or tools.core() for 4 essentials\n)\n\ntask = Task(\n    description=\"Create a morning briefing on Japanese markets\",\n    expected_output=\"Structured market report with key takeaways\",\n    agent=analyst,\n)\n\ncrew = Crew(agents=[analyst], tasks=[task])\nresult = crew.kickoff()\n```\n\n### Standalone (No Framework)\n\n```python\nfrom integrations.transcode_langchain import TranscodeClient\n\nclient = TranscodeClient(api_key=\"your-api-key\")\nbriefing = client.briefing()\nintel = client.intelligence(\"7203\")  # Toyota\n```\n\n## Batch API (Developer/Pro)\n\n```bash\n# Multi-ticker intelligence\nPOST /api/v1/batch/intelligence   {\"tickers\": [\"7203\", \"6501\", \"9984\"]}\n\n# Multi-ticker disclosures\nPOST /api/v1/batch/disclosures    {\"tickers\": [\"7203\", \"6501\"], \"days\": 3}\n\n# Bulk ticker resolution\nPOST /api/v1/batch/tickers        {\"tickers\": [\"7203\", \"6501\", \"9984\"]}\n```\n\n## AI-Summarized Disclosures (Exclusive)\n\n```bash\n# English AI summaries + impact scoring for all disclosures\nGET /api/v1/disclosures/summarized?days=3&min_impact=3\n```\n\nReturns:\n```json\n{\n  \"ai_summary\": {\n    \"summary_en\": \"Share buyback announced by Toyota, signals undervaluation view\",\n    \"impact_score\": 4,\n    \"sector_relevance\": \"Automotive, Manufacturing\",\n    \"source\": \"gemini\"\n  }\n}\n```\n\n## Telemetry\n\n```bash\nGET /api/v1/telemetry/today       # Today's API usage stats\nGET /api/v1/telemetry/history     # Historical usage (7 days default)\n```\n\n## Quick Start\n\n```bash\n# 1. Clone\ngit clone https://github.com/hiroshic9-png/japan-intelligence-api.git\ncd japan-intelligence-api\n\n# 2. Setup\npython -m venv venv && source venv/bin/activate\npip install -r requirements.txt\n\n# 3. Configure\ncp .env.example .env\n# Edit .env with your API keys\n\n# 4. Run\npython -m api.main\n# → http://localhost:8080/docs\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `EDINET_API_KEY` | Yes | EDINET disclosure API key |\n| `GEMINI_API_KEY` | Yes | Google Gemini API key (Layer 2 interpretation) |\n| `GBIZ_API_TOKEN` | Yes | gBizINFO API token |\n| `ESTAT_APP_ID` | Yes | e-Stat application ID |\n| `JQUANTS_API_KEY` | Yes | J-Quants v2 API key |\n| `FRED_API_KEY` | Yes | FRED API key |\n| `JI_API_KEY` | Optional | API authentication key (enables auth when set) |\n| `JI_API_KEYS` | Optional | Multi-tier keys: `{\"key\": \"tier\"}` |\n\n## API Documentation\n\nInteractive documentation:\n- **Swagger UI**: https://japan-intelligence-api.onrender.com/docs\n- **ReDoc**: https://japan-intelligence-api.onrender.com/redoc\n\n## License\n\nProprietary. All rights reserved.\n\n",
  "bytes": 11843,
  "sha": "da978c6b9eb7f67edabb15efd4521c021acbc62e87887bf2b92dbe2649238a78",
  "repo_slug": "hiroshic9-png/japan-intelligence-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hiroshic9_png_transcode_f270a632/readme"
}