← на карту

Разработчикам

Open API v1 · MCP-сервер · только чтение

Данные f-tracker.ru — где сейчас есть топливо на АЗС — открыты для ваших проектов и ИИ-ассистентов. Это та же сведённая картина, что на карте: вердикт по каждой АЗС, возраст свежайшего свидетельства, отметки водителей, очереди, лимиты и подтверждённые цены.

1. Доступ: без ключа или с ключом

Без ключаС ключом
MCPдада
Open API (REST)нетда
Вызовов в час60 на IP-адрес600 на ключ (можно больше)
АЗС за один ответдо 20до 50 в MCP, до 200 в Open API

MCP можно подключить прямо сейчас, без ключа и переписки — этого хватает, чтобы спрашивать ассистента о своём городе. Ключ нужен для Open API и для больших объёмов.

Ключ — персональный, вида ft_live_…, один и для Open API, и для MCP. Чтобы получить ключ, напишите на webmaster@akulichev.com: в двух словах, что за проект и примерно сколько запросов в час нужно. Ключ показывается один раз — сохраните его в менеджере паролей.

Ключ — секрет. Не публикуйте его в репозитории и не вставляйте в адрес страницы: он передаётся только заголовком Authorization: Bearer ….

2. MCP-сервер для ИИ-ассистентов

Model Context Protocol позволяет ассистенту самому спрашивать у f-tracker.ru, где есть топливо, — например: «где сейчас заправиться АИ-95 в Сургуте без очереди?».

Инструменты (все только читают данные):

Вызов инструмента расходует один запрос из почасового лимита — ключа или, без ключа, вашего IP-адреса; подключение и список инструментов — бесплатно.

3. Подключение клиентов

Без ключа — за минуту

Claude (claude.ai и приложения): «Настройки → Коннекторы → Добавить свой коннектор», адрес https://f-tracker.ru/mcp, авторизацию не указывать.

Claude Code, терминал
claude mcp add --transport http f-tracker https://f-tracker.ru/mcp

В остальных клиентах — те же конфиги, что ниже, только без заголовка Authorization (для Claude Desktop — без аргументов --header и без env).

С ключом

Во всех примерах ниже замените ft_live_ВАШ_КЛЮЧ на свой ключ.

Claude Code

терминал
claude mcp add --transport http f-tracker https://f-tracker.ru/mcp --header "Authorization: Bearer ft_live_ВАШ_КЛЮЧ"

Claude Desktop

Через мост mcp-remote (нужен Node.js 18+). Файл настроек — «Settings → Developer → Edit Config» (claude_desktop_config.json):

claude_desktop_config.json
{
  "mcpServers": {
    "f-tracker": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://f-tracker.ru/mcp",
               "--header", "Authorization: Bearer ${FT_KEY}"],
      "env": { "FT_KEY": "ft_live_ВАШ_КЛЮЧ" }
    }
  }
}

После сохранения перезапустите Claude Desktop.

Cursor

~/.cursor/mcp.json или .cursor/mcp.json в проекте
{
  "mcpServers": {
    "f-tracker": {
      "url": "https://f-tracker.ru/mcp",
      "headers": { "Authorization": "Bearer ft_live_ВАШ_КЛЮЧ" }
    }
  }
}

VS Code (GitHub Copilot, режим агента)

.vscode/mcp.json
{
  "inputs": [
    { "type": "promptString", "id": "ft-key", "description": "Ключ f-tracker.ru", "password": true }
  ],
  "servers": {
    "f-tracker": {
      "type": "http",
      "url": "https://f-tracker.ru/mcp",
      "headers": { "Authorization": "Bearer ${input:ft-key}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "f-tracker": {
      "serverUrl": "https://f-tracker.ru/mcp",
      "headers": { "Authorization": "Bearer ft_live_ВАШ_КЛЮЧ" }
    }
  }
}

Свой агент или другой клиент

Любой клиент MCP с поддержкой Streamable HTTP и своих заголовков. Если клиент умеет только локальные (stdio) серверы — используйте тот же мост, что для Claude Desktop: npx -y mcp-remote https://f-tracker.ru/mcp --header "Authorization: Bearer …". Проверить ключ и связь можно без клиента:

терминал
curl -s https://f-tracker.ru/mcp \
  -H "Authorization: Bearer ft_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"city_summary","arguments":{"city":"surgut"}}}'

4. Open API

Обычный REST с JSON для своих сайтов, ботов и дашбордов. Базовый адрес — https://f-tracker.ru/openapi/v1, машинная спецификация OpenAPI 3.1 — /openapi.json.

терминал
curl -s "https://f-tracker.ru/openapi/v1/stations?city=surgut&fuel=ai95&limit=5" \
  -H "Authorization: Bearer ft_live_ВАШ_КЛЮЧ"

Лимиты по умолчанию — 600 запросов в час и 5 в секунду на ключ, до 200 АЗС на страницу; остаток — в заголовках RateLimit-*. Ответы поддерживают ETag: повторный запрос с If-None-Match вернёт 304.

5. Как читать данные и правила