Per sviluppatori e agenti AI
Lo stesso catalogo, per le macchine.
Un assistente AI che deve trovare un bando per il suo utente non dovrebbe leggere pagine web. Qui trova un server MCP e un'API REST con 15 strumenti: ricerca, matching, scadenze, comuni, lavoro da remoto e i servizi a pagamento, che l'agente può ordinare per l'utente.
MCP
Indirizzo: https://occasioni.it/mcp (streamable HTTP). Funziona con Claude, ChatGPT e ogni client MCP. La chiave è facoltativa: senza, hai 120 chiamate all'ora.
# Claude Code
claude mcp add --transport http occasioni https://occasioni.it/mcp
# con chiave
claude mcp add --transport http occasioni https://occasioni.it/mcp \
--header "Authorization: Bearer op_..."
REST
Ogni strumento è anche un endpoint: GET o POST /api/v1/<strumento>. Descrizione completa in openapi.json; per i modelli c'è llms.txt.
curl https://occasioni.it/api/v1/match_business \
-H "Content-Type: application/json" \
-d '{"region":"Puglia","size":"Microimpresa",
"sector":"Turismo","purposes":["Digitalizzazione"]}'
Strumenti
search_incentives | Cerca bandi e incentivi Search Italian public grants, incentives and calls (national catalogue incentivi.gov.it plus regional and chamber-of-commerce calls), refreshed nightly. Open calls only by default. Text in Italian. |
get_incentive | Scheda completa di un bando Full card of one incentive: requirements, beneficiaries, eligible costs, amounts, deadline, official link and the source summary. |
match_business | Bandi adatti a un'attività Ranks the open calls for a business profile and explains each score in plain Italian. No model call: a transparent database score. |
closing_soon | Bandi in scadenza Open calls closing within N days (default 30), soonest first. |
catalogue_stats | Numeri del catalogo Live numbers: open calls, calls closing in 30 days, grants, total budget, remote jobs, places, and per-region counts. |
search_remote_jobs | Lavori da remoto aperti all'Italia Remote jobs workable from Italy (Jobicy, Remotive, Himalayas; credit and apply link kept). Filter by text or skill area. |
search_places | Comuni italiani Italian municipalities (all 7,900) with population, coordinates and any programme that pays people to move there (1-euro houses, residence bonuses). |
get_place | Scheda di un comune One municipality: population, province, coordinates, programmes for new residents, and the regional incentives open to people. |
relocation_programmes | Programmi per chi si trasferisce Verified programmes that pay or help people to move: 1-euro houses, residence bonuses, subsidised homes, remote-worker schemes. Each with its official source. |
plan_preview | Anteprima del piano per ripartire Free preview of the secondlife.it personal plan: how many places, remote jobs and incentives fit a person, with the top few of each. No model call. |
catalogue_trends | Andamento dei bandi nel tempo Time series of the Italian incentives catalogue since 2021: calls opened per month, calls open at mid-month, calls closing per month, seasonality (which months are busy), a 6-month estimate with range, and which purposes are growing. Optional region. |
expected_calls | Bandi che tornano Calls that recur every year (same body, same call, opened in at least two years): past openings, usual month and the expected next opening date, with a confidence level. Use it to tell a user when a closed call should reopen. |
list_products | Servizi a pagamento Paid services an agent can order for its user (eligibility check, application draft, personal plan, municipality dossier, remote-job kit) and subscriptions. |
create_order | Ordina un servizio per l'utente Orders a paid report. With an API key that has credit, it is paid at once and generated; otherwise it returns a checkout_url to hand to the human (Stripe), who pays and receives the report by email. Input depends on the product: verifica/bozza need ref (incentive id) and input (business profile + project); piano needs input (questionnaire answers); luogo needs ref (place id); kit needs input.cv, input.role and input.jobs (remote-job ids). |
get_order | Stato e contenuto di un ordine Status of an order by its token; when ready, the full report as structured JSON. |
Chiave API e credito per gli agenti
Gratis
Chiave personale, 300 chiamate al giorno. Basta l'email.
API · 49 €/mese
50.000 chiamate al giorno, per software e servizi che rivendono i dati ai loro clienti.
Credito prepagato
Ricarichi una volta e l'agente ordina verifiche, bozze e piani senza far pagare l'utente a ogni passo. Il report arriva subito, nella risposta.