コンテンツにスキップ

Getting Started

要約 (summary): AutonoMath を 5 分で試すためのガイド。API key 発行・curl / Python / Node の最小例・Claude Desktop 連携まで。

1. インストール (Install)

Python (REST + MCP server)

pip install AutonoMath

SDK (coming soon)

# Python SDK — coming soon
pip install jpintel  # 未公開

# TypeScript SDK — coming soon
npm install @jpintel/sdk  # 未公開

現状は直接 HTTP を叩く形か、AutonoMath の MCP server を利用。

2. API key を取得する (Get an API key)

Free tier (即時発行)

API key 未設定でリクエストを送ると自動的に free tier (100 requests/day) 扱いになる。以下の curl がそのまま動く。

100 req/day を超えて使いたければ Stripe Checkout でカードを登録する。

curl -X POST https://api.autonomath.ai/v1/billing/checkout \
  -H "Content-Type: application/json" \
  -d '{
    "success_url": "https://autonomath.ai/success.html?session_id={CHECKOUT_SESSION_ID}",
    "cancel_url": "https://autonomath.ai/pricing.html",
    "customer_email": "you@example.com"
  }'

返り値の url にブラウザで飛ぶと Stripe Checkout。カード登録完了後、success_url?session_id=... が返る。landing 側を使うなら https://autonomath.ai/success.html?session_id=... (API key 自動発行 + curl snippet 表示) で終わる。自前の UI から叩くなら:

curl -X POST https://api.autonomath.ai/v1/billing/keys/from-checkout \
  -H "Content-Type: application/json" \
  -d '{"session_id": "cs_live_..."}'
# => {"api_key": "jpintel_xxxxxxxxxxxxxxxx", "tier": "paid", "customer_id": "cus_..."}

API key は発行時 1 回だけ返る — 保存し忘れると /v1/billing/portal でサブスクリプション解約後、再発行する必要がある。

詳細は pricing.md と api-reference.md#billing 参照。

3. 最初のリクエスト (curl)

curl -H "X-API-Key: jpintel_xxxxxxxxxxxxxxxx" \
  "https://api.autonomath.ai/v1/programs/search?q=IT導入"

API key 無しでも動く (free tier):

curl "https://api.autonomath.ai/v1/programs/search?q=IT導入&limit=5"

4. Python 例 (requests, stdlib のみ)

import requests

API_KEY = "jpintel_xxxxxxxxxxxxxxxx"
BASE = "https://api.autonomath.ai"

r = requests.get(
    f"{BASE}/v1/programs/search",
    params={"q": "IT導入", "tier": ["S", "A"], "limit": 5},
    headers={"X-API-Key": API_KEY},
)
r.raise_for_status()
print(r.json()["total"], "results")

5. Node.js 例 (fetch)

const API_KEY = "jpintel_xxxxxxxxxxxxxxxx";
const BASE = "https://api.autonomath.ai";

const url = new URL(`${BASE}/v1/programs/search`);
url.searchParams.set("q", "IT導入");
url.searchParams.append("tier", "S");
url.searchParams.append("tier", "A");

const res = await fetch(url, { headers: { "X-API-Key": API_KEY } });
const data = await res.json();
console.log(`${data.total} results`);

6. MCP (Claude Desktop) 設定

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) を編集:

{
  "mcpServers": {
    "jpintel": {
      "command": "AutonoMath",
      "env": {
        "JPINTEL_DB_PATH": "/path/to/jpintel.db"
      }
    }
  }
}
  • AutonoMath バイナリは pip install AutonoMath で PATH に入る
  • JPINTEL_DB_PATH は任意 (デフォルト ./data/jpintel.db)
  • Claude Desktop を再起動すると 5 つのツール (search_programs, get_program, list_exclusion_rules, check_exclusions, get_meta) が使える

詳細は mcp-tools.md。

7. 5 秒スモークテスト (5-second smoke test)

動作確認用:

# health check (認証不要)
curl https://api.autonomath.ai/healthz
# => {"status":"ok"}

# dataset 全体像
curl https://api.autonomath.ai/meta
# => {"total_programs": 6771, "tier_counts": {...}, ...}

両方 200 が返れば導入成功。

次は

  • api-reference.md — 全エンドポイントの param / response 定義
  • exclusions.md — 排他ルールの使い方
  • faq.md — rate limit / データ更新頻度 / SLA 等