OpenAI Codex CLI / Agents SDK から jpcite REST/OpenAPI 接続

5 分接続手順

1. OpenAPI spec を確認: https://jpcite.com/openapi.agent.gpt30.json または API reference を確認。
2. REST helper を作る: https://api.jpcite.com/v1/programs/search を params と X-API-Key で呼び出す。
3. Agent に bind: その helper を利用中の agent framework の function tool として登録。
4. (任意) API key を渡す: JPCITE_API_KEY を設定すると metered モードへ昇格。anon free のままなら未設定で可。
5. MCP が必要な場合: hosted HTTP ではなく uvx autonomath-mcp を stdio 接続で使う。

copy-paste snippet

REST helper を agent framework 側の function tool として登録するための最小サンプル。

import os
import requests

def search_programs(q: str, prefecture: str = "東京都") -> dict:
    headers = {}
    if os.environ.get("JPCITE_API_KEY"):
        headers["X-API-Key"] = os.environ["JPCITE_API_KEY"]
    response = requests.get(
        "https://api.jpcite.com/v1/programs/search",
        params={"q": q, "prefecture": prefecture},
        headers=headers,
        timeout=20,
    )
    response.raise_for_status()
    return response.json()

# 上の helper を利用中の Agents SDK / agent framework の function tool として登録してください。
print(search_programs("ものづくり補助金", "東京都"))

動作確認

REST 経由で ものづくり補助金 東京都 を検索し、source_url 付きの JSON が返ることを確認します。MCP tools は stdio package から利用し、36協定書面の生成機能は公開提供していません。

REST 直叩きで疎通確認する場合は -G --data-urlencode を必ず使うこと。日本語 query を URL に直接埋めると HTTP リクエスト行が壊れ、API は {"error":{"code":"bad_request",...,"hint":"Use --data-urlencode for non-ASCII query params..."}} を返します。

curl -G "https://api.jpcite.com/v1/programs/search" \
  --data-urlencode "q=ものづくり補助金" \
  --data-urlencode "prefecture=東京都" \
  -H "X-API-Key: ${JPCITE_API_KEY:-}"

FAQ