Vibe coding · Agenti IA

Costruire con PinnFeed e l'IA

Aggiornato il 9 novembre 2026 · PinnFeed · 2 min di lettura

Risposta: prendi una chiave Free dalla registrazione, esporta PINNFEED_KEY, incolla un prompt di questa pagina in Cursor, Claude, ChatGPT, Lovable, Replit o Bolt e dai all'agente llms-api.txt o AGENTS.md. L'autenticazione usa x-api-key (oppure Bearer o ?key=). Il WebSocket richiede Builder (99 €/mese).

1. La chiave in un minuto#

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

Non incollare mai la chiave in una chat condivisa o in git. Free = REST con circa 30 s di ritardo, 2 sport, 1 req/s, 1.000 al giorno. Hobby = REST in tempo reale, senza WebSocket. Builder = il piano WebSocket. Dettagli: prezzi, quickstart.

2. Verifica la chiave#

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

OpenAPI: /openapi.json. Postman / Insomnia: collection JSON (variabile apiKey).

3. Dai all'agente la vera API#

API compatta: llms-api.txt
Convenzione Cursor / Codex: AGENTS.md
Skill del prodotto: SKILL.md
Docs (in inglese): docs · WebSocket · MCP · errori

4. MCP (trasporti reali)#

MCP ospitato: POST https://pinnfeed.io/mcp (Streamable HTTP). Auth: Authorization: Bearer, x-api-key, oppure ?key= se il client non può inviare header.

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

Per Claude Desktop, Claude web o i connettori ChatGPT che non accettano header: https://pinnfeed.io/mcp?key=YOUR_KEY con una chiave dedicata che puoi revocare. Strumenti: get_account, list_sports, search_events, get_live_odds, get_prematch_odds, get_event, get_drops, get_closing_odds.

5. Prompt base (Cursor / Claude Code)#

I prompt sono in inglese, come la documentazione che l'agente leggerà:

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.

Altri prompt (ChatGPT, Lovable, Replit) e 8 idee di app: hub vibe coding in inglese.

Prova#

Builder (99 €/mese) per il WebSocket e lo storico delle quote di chiusura. Prova di 3 giorni; serve una carta, addebitata dopo il giorno 3 se non disdici prima. Chiave gratuita: registrazione.

Contenuto educativo per maggiorenni (18+). Le regole sul gioco cambiano da paese a paese; in Italia il gioco è regolato dall'ADM. Questo non è un parere legale.

Domande frequenti#

Serve Builder per il vibe coding?#

No per prototipi REST su Free o Hobby. Sì per /v1/stream e /v1/closing.

L'agente può inventare endpoint?#

Non deve: vincolalo all'OpenAPI e a llms-api.txt.

Il server MCP consuma quota?#

Sì, ogni tools/call conta come una richiesta REST.