﻿# Построить продукт с AI

## Промпт для первого продукта

После публикации документации передай агенту этот промпт. До публикации укажи локальный адрес документации вместо production-домена.

```text
Собери веб-приложение сравнения цен CS2 на CSFolder Data API.
Сначала прочитай https://docs.csfolder.com/llms.txt и /openapi.json.
Прочитай /downloads/manifest.json, скачай SDK по URL с того же домена,
проверь SHA-256 и размер, затем установи локальный архив с --ignore-scripts.
Используй только операции и поля из текущего контракта.
Сделай поиск предметов, таблицу ask/bid по маркетам и дневной график.
Ключ получай только из CSFOLDER_API_KEY на сервере.
Не проси вставлять ключ в чат и не отправляй его в браузер.
Сохраняй идентичность item_id, фазы, износа и StatTrak/Souvenir.
Показывай валюту, единицы, источник и доступное время данных.
Не выдумывай отсутствующие цены, точки графика или продажи.
Добавь пагинацию, кэш 30 минут, таймаут и ограниченные ретраи 429/503.
Протестируй: валидный результат, пустая история, 401, 429 и 503.
Если нужного метода нет — объясни ограничение, не придумывай endpoint.
Не публикуй приложение и не подключай платные сервисы без подтверждения.
```

## Что означает «один промпт»

Для продукта на всём каталоге попроси агента прочитать [полную выгрузку цен](/ru/market-snapshots/), обрабатывать NDJSON построчно во временное хранилище и проверять соответствующую запись `end` до замены рабочего набора. Не запрашивай цену каждого предмета отдельно и не считай HTTP 200 доказательством полной выгрузки.

Агент получает контракт, примеры и критерии проверки, чтобы собрать поддерживаемую интеграцию. Владелец всё равно сам авторизуется, выдаёт ключ и разрешает доступ к приватным данным. Произвольный продукт или доступ к чужому портфелю этим не гарантируются.

## Форматы для агента

Для серверной интеграции на Node.js используй [TypeScript SDK](/ru/typescript-sdk/), если доступен его локальный архив. Он использует общий контракт, проверяет ответы и полноту потоковой выгрузки. Публикации в npm пока нет: не придумывай команду установки публичной версии.

- [Манифест загрузок](/downloads/manifest.json) — архивы SDK/MCP, контрольные суммы и хеш контракта.
- [OpenAPI](/openapi.json) — операции, ограничения входных данных и авторизация.
- [llms.txt](/llms.txt) — карта документации.
- [llms-full.txt](/llms-full.txt) — все англоязычные гайды в одном файле.
- [Markdown этого гайда](/markdown/ru/build-with-ai.md) — без навигации и клиентского JavaScript.

Локально проверенные [MCP и устанавливаемый skill](/ru/mcp-and-skill/) дают агенту ограниченные инструменты, встроенный контракт и сценарии интеграции. Используй подготовленный архив: публичной npm-версии и hosted MCP пока нет.

`llms.txt` помогает прочитать документацию, но сам по себе не обеспечивает рекомендации или индексацию в AI-поиске. Не устанавливай пакеты, придуманные агентом.
