バイブコーディング · AIエージェント

PinnFeedとAIで作る

更新日 2026年11月9日 · PinnFeed · 約1分で読めます

回答： 登録で無料キーを取得し、PINNFEED_KEYを環境変数に設定します。このページのプロンプトをCursor、Claude、ChatGPT、Lovable、Replit、Boltに貼り付け、エージェントにはllms-api.txtかAGENTS.mdを読ませてください。認証はx-api-key（またはBearer、?key=）です。WebSocketにはBuilder（月額99ユーロ）が必要です。

1. キーを1分で#

export PINNFEED_KEY="ps_live_..."
echo 'PINNFEED_KEY=ps_live_...' >> .env
echo '.env' >> .gitignore

共有するチャットやgitにキーを貼らないでください。Free＝約30秒遅延のREST、2競技、1 req/s、1日1,000件。Hobby＝リアルタイムREST（WebSocketなし）。Builder＝WebSocketプラン。詳細：料金、クイックスタート。

2. キーの動作確認#

curl -sS -H "x-api-key: $PINNFEED_KEY" \
  "https://pinnfeed.io/v1/odds?sport=soccer&main=true&limit=3"

OpenAPI：/openapi.json。Postman / Insomnia：コレクションJSON（変数apiKey）。

3. エージェントに本物のAPIを渡す#

コンパクトなAPI：llms-api.txt
Cursor / Codexの規約：AGENTS.md
プロダクトのスキル：SKILL.md
ドキュメント（英語）：docs · WebSocket · MCP · エラー

4. MCP（実際のトランスポート）#

ホスト型MCP：POST https://pinnfeed.io/mcp（Streamable HTTP）。認証はAuthorization: Bearer、x-api-key、ヘッダーを送れないクライアントでは?key=。

{
  "mcpServers": {
    "pinnfeed": {
      "url": "https://pinnfeed.io/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

claude mcp add --transport http pinnfeed https://pinnfeed.io/mcp \
  --header "Authorization: Bearer YOUR_KEY"

ヘッダーを設定できないClaude Desktop、Claude web、ChatGPTのコネクタでは、取り消せる専用キーでhttps://pinnfeed.io/mcp?key=YOUR_KEYを使います。ツール：get_account、list_sports、search_events、get_live_odds、get_prematch_odds、get_event、get_drops、get_closing_odds。

5. 基本プロンプト（Cursor / Claude Code）#

エージェントが読むドキュメントに合わせ、プロンプトは英語のままにしています：

You are building against PinnFeed (Pinnacle odds API).
1) Read https://pinnfeed.io/llms-api.txt and https://pinnfeed.io/openapi.json.
2) Use env PINNFEED_KEY only (x-api-key). Add .env to .gitignore.
3) Goal: YOUR_GOAL
4) Prefer REST on Free/Hobby; WebSocket only if I confirm Builder.
5) Educational, 18+. No betting tips, no guaranteed profit.

ほかのプロンプト（ChatGPT、Lovable、Replit）と8つのアプリ案：英語のバイブコーディングハブ。

無料トライアル#

WebSocketとクロージングオッズ履歴はBuilder（月額99ユーロ）。3日間の無料トライアルにはカード登録が必要で、それまでに解約しない場合は3日目の終了後に課金されます。無料キー：登録。

18歳以上の方を対象とした教育目的のコンテンツです。賭博に関するルールは国によって異なり、日本では刑法により賭博は原則として禁止されています。これは法的助言ではありません。

よくある質問#

バイブコーディングにBuilderは必要？#

FreeやHobbyでのRESTの試作には不要です。/v1/streamと/v1/closingには必要です。

エージェントがエンドポイントを作り出すことは？#

させないでください。OpenAPIとllms-api.txtに固定します。

MCPはクォータを消費しますか？#

はい。tools/call1回がRESTリクエスト1回として数えられます。