Risorse per AI e LLM

Versioni in markdown semplice di questi documenti, llms.txt, OpenAPI, la competenza per agenti e gli altri file leggibili dagli strumenti AI.

Questi documenti sono scritti per essere letti da strumenti AI così come da persone. Usali per fornire a Claude, ChatGPT, Cursor o al tuo agente informazioni accurate e aggiornate su TradeCatalog.

Versioni in markdown di ogni paginaCollegamento a questa sezione#

Ogni pagina dei documenti è anche in markdown semplice:

Aggiungi .md all'URL: /docs/api/products diventa /docs/api/products.md.
Oppure chiedi il markdown: invia Accept: text/markdown a qualsiasi URL /docs.

bash

curl https://tradecatalog.app/docs/api/products.md
curl -H "Accept: text/markdown" https://tradecatalog.app/docs/api/products

Alcune altre pagine di TradeCatalog restituiscono il markdown quando richiesto con Accept: text/markdown.

Pulsanti su ogni paginaCollegamento a questa sezione#

Nella parte superiore di ogni pagina dei documenti:

Copia pagina copia la pagina in formato markdown, pronta da incollare in una chat.
Visualizza come markdown apre la versione .md.
Apri in Claude e Apri in ChatGPT avviano una nuova chat che legge la pagina, così puoi porre domande su di essa.

Ogni blocco di codice ha anche un pulsante Copia.

llms.txt e llms-full.txtCollegamento a questa sezione#

File	Cosa contiene
/llms.txt	Un breve riassunto di TradeCatalog e collegamenti alle pagine principali, seguendo la convenzione llms.txt.
/llms-full.txt	Tutte le pagine dei documenti in un unico file markdown. Incollalo in un progetto o forniscilo a un agente per un contesto completo.

Per gli assistenti di programmazione, aggiungi /llms-full.txt al tuo progetto, o fai sapere all'assistente di leggerlo prima di scrivere il codice TradeCatalog.

OpenAPICollegamento a questa sezione#

/api/v1/openapi.json descrive ogni endpoint REST. Gli agenti che comprendono OpenAPI possono pianificare chiamate API direttamente da esso.

File di scopertaCollegamento a questa sezione#

File	Per
`/.well-known/api-catalog`	Catalogo API RFC 9727: collegamenti al server MCP, all'API REST, a OpenAPI e a questi documenti.
`/.well-known/mcp/server-card.json`	Scheda del server MCP: URL, trasporto, autenticazione e strumenti.
`/.well-known/agent-skills/index.json`	Una competenza per agenti che descrive come utilizzare TradeCatalog.
`/.well-known/ai-catalog.json`	Indice del server MCP e della competenza.
`/.well-known/oauth-protected-resource/mcp`	Metadati OAuth per il server MCP. Vedere OAuth per client MCP.
`/auth.md`	Come gli agenti si autenticano, in una sola pagina.

Lascia che le app AI utilizzino i tuoi datiCollegamento a questa sezione#

Leggere i documenti è una cosa. Per permettere a un'app AI di cercare i tuoi prodotti, prezzi e ordini reali, collegala al server MCP. Si autentica come te e vede solo ciò che puoi vedere tu.