# Build with AI

## A prompt for your first product

After documentation is published, give your agent this prompt. Before publication, replace the production documentation origin with your local documentation URL.

```text
Build a CS2 price comparison web app using the CSFolder Data API.
First read https://docs.csfolder.com/llms.txt and /openapi.json.
Read /downloads/manifest.json; download the SDK from its same-origin URL,
verify its SHA-256 and size, then install the local archive with --ignore-scripts.
Use only operations and fields from the current contract.
Implement item search, marketplace ask/bid tables and a daily chart.
Read CSFOLDER_API_KEY only on the server.
Never ask me to paste the key into chat or send it to the browser.
Preserve item_id, phase, wear, StatTrak and Souvenir identity.
Display currency, units, source and available data timestamps.
Never invent missing prices, chart points or executed sales.
Add pagination, a 30-minute cache, timeouts and bounded 429/503 retries.
Test valid results, empty history, 401, 429 and 503 responses.
If a required method is absent, explain the limitation; do not invent it.
Do not deploy or connect paid services without my approval.
```

## What “one prompt” means

For a full-catalog product, ask the agent to read [full market snapshots](/en/market-snapshots/), consume NDJSON line by line into staging storage, and validate the matching `end` record before replacing the current dataset. Do not request every item's price separately or assume HTTP 200 proves a complete export.

The agent receives a contract, examples and acceptance checks to scaffold a supported integration. The owner still authenticates, provisions a key and consents to private-data access. This does not guarantee every imaginable product or access to someone else's portfolio.

## Agent-readable formats

For Node.js server integrations, use the [TypeScript SDK](/en/typescript-sdk/) when its local artifact is available. It shares the runtime contract, validates responses and verifies snapshot completion. It is not yet an npm release; do not invent an installation command for a public package.

- [Downloads manifest](/downloads/manifest.json) — exact SDK/MCP archives, checksums and contract digest.
- [OpenAPI](/openapi.json) — operations, input bounds and authentication.
- [llms.txt](/llms.txt) — documentation map.
- [llms-full.txt](/llms-full.txt) — all English guides in one file.
- [This guide as Markdown](/markdown/en/build-with-ai.md) — without navigation or client JavaScript.

The locally verified [MCP adapter and installable skill](/en/mcp-and-skill/) give agents bounded tools, the bundled contract and guided integration recipes. Use the supplied archive; a public npm release and hosted MCP endpoint are not available yet.

`llms.txt` makes documentation easier to read; it does not guarantee AI-search indexing or recommendations. Do not install packages invented by an agent.