К основному содержанию
скилл CX Codex

derive-client — скилл для Claude Code: что делает и как установить

Скилл derive-client записывает сетевой трафик сайта через браузер в HAR-файл и генерирует автономный API-клиент или CLI без повторного запуска браузера.

Apache-2.0 ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install agent-browser@claude-settings
Открыть на GitHub

Что делает derive-client

Скилл автоматизирует реверс-инжиниринг внутренних API сайтов. Сначала утилита agent-browser перехватывает сетевые запросы при прокликивании сценариев и сохраняет ответы вместе со структурой в HAR-архив. Затем фильтрует телеметрию с помощью jq, извлекает схемы ответов, заголовки авторизации и генерирует готовый код клиента на каждый пользовательский сценарий.

Для работы требуются установленный agent-browser и утилита jq. Готовый код читает куки и токены из внешних файлов или переменных окружения, чтобы сессионные данные не попадали в репозиторий. Лимит на тело одного ответа в HAR составляет 2 MB.

Файлы HAR содержат действующие сессионные токены, поэтому их нельзя коммитить в систему контроля версий. Скилл сразу проверяет сгенерированные функции живыми запросами к сайту.

Какие задачи решает

  • перехватить сетевые запросы сайта в HAR через agent-browser
  • выделить внутренние эндпоинты JSON API среди аналитики
  • сгенерировать скрипт или CLI для прямых HTTP-вызовов
  • экспортировать сессионные куки для работы без браузера

Примеры запросов агенту

  • Сделай CLI-клиент для поиска на этом сайте на основе записанного HAR-файла
  • Запиши сетевые запросы поиска и открой детальную страницу товара
  • Изучи эндпоинты в /tmp/site.har и напиши функции для запросов с авторизацией

Как установить derive-client

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install agent-browser@claude-settings

Команда ставит плагин agent-browser целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add fcakyon/claude-codex-settings --skill derive-client -a claude-code

3Вручную: положить файлы

~/.claude/skills/derive-client/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/derive-client/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о derive-client

Как установить derive-client в Claude Code?

Для быстрой установки выполните npx skills add fcakyon/claude-codex-settings --skill derive-client -a claude-code. Второй вариант — подключить плагин через две команды: сначала /plugin marketplace add fcakyon/claude-codex-settings, а затем /plugin install agent-browser@claude-settings.

Что делает скилл derive-client?

Он перехватывает трафик браузерной сессии в HAR-файл, отсеивает аналитику и пишет самостоятельный код клиента для прямого обращения к внутренним API.

Как в сгенерированном клиенте передаются авторизация и куки?

Скилл выгружает текущую сессию командой agent-browser cookies get --json в файл cookies.json. Сгенерированный клиент считывает заголовки и токены из файла или переменных окружения без сохранения секретов в исходном коде.

Исходный текст

SKILL.md · Apache-2.0
---
name: derive-client
description: Reverse-engineer a website's internal API by recording browser traffic into a HAR file, then generate a standalone client or CLI that calls the endpoints directly, with no browser needed after the first recording. Use when asked to "derive a client", "build a CLI for <site>", "reverse engineer this site's API", "record network requests", "turn this site into an API", or when the same site will be automated repeatedly and direct HTTP calls would beat driving the browser every time.
allowed-tools: Bash(agent-browser:*), Bash(npx agent-browser:*)
license: Apache-2.0
---

# Derive an API client from a recorded session

Driving a browser is the right tool for the first visit and the wrong tool for the hundredth. This skill records a site's network traffic once while you use it, then turns the captured requests into a standalone client (script, CLI, or library) that talks to the site's internal API directly.

The recording alone contains everything needed: agent-browser embeds text response bodies (JSON/HTML/JS) in the HAR by default, so endpoint shapes can be studied offline after the browser is closed.

## Workflow

```
1. Record     Start HAR capture, drive the flows you want in the client
2. Identify   Find the real API endpoints among the noise
3. Extract    Pull request shapes, response schemas, and auth material
4. Generate   Write the client, one function per flow
5. Verify     Call every endpoint for real before declaring done
```

## 1. Record

```bash
agent-browser network har start          # embeds text response bodies by default
# ... drive the site: search, open a detail page, paginate, etc. ...
agent-browser network har stop /tmp/site.har
```

- Exercise **every flow the client should support**, and run each one at least twice with different inputs (two search terms, two detail pages). Diffing the recorded URLs reveals which parts are parameters.
- If the site needs login, log in **before** starting the HAR so credentials don't land in the recording unnecessarily. The session cookies are exported separately in step 3.
- `--content all` embeds binary bodies too (base64); `--content none` disables embedding. Per-body cap is 2 MB.

While the session is still open, `agent-browser network requests` and `network request <id>` give the same data interactively — but only the HAR survives navigation and browser close, so prefer it for anything multi-page.

## 2. Identify endpoints

Query the HAR with `jq`:

```bash
# All JSON API calls: method, URL, status
jq -r '.log.entries[]
  | select(.response.content.mimeType | test("json"))
  | "\(.request.method) \(.response.status) \(.request.url)"' /tmp/site.har
```

Ignore analytics and infrastructure noise: telemetry endpoints (`/collect`, `/track`, `/beacon`, `/log`), third-party domains (google-analytics, segment, sentry, datadog, intercom, hotjar), and static assets. The real API is usually first-party, JSON, and correlates with the actions you performed.

## 3. Extract shapes and auth

```bash
# Full detail for one endpoint: request headers, POST body, response body
jq '.log.entries[] | select(.request.url | test("api/search"))
  | {request: {method: .request.method, headers: .request.headers,
     postData: .request.postData.text},
     response: .response.content.text}' /tmp/site.har
```

- **Response schema**: read `.response.content.text` — this is the real payload, use it to derive types.
- **Auth**: compare request headers across endpoints. Look for `authorization`, `cookie`, `x-csrf-token`, `x-api-key`, and site-specific `x-*` headers. Replay only the ones that matter — test by omission in step 5.
- **Cookies**: export the live session with `agent-browser cookies get --json > cookies.json` for the client to load at runtime. Never hardcode cookie values into generated source.

## 4. Generate the client

- One function per recorded flow (`search(query)`, `getItem(id)`), typed from the observed response bodies.
- Auth material (cookies, bearer tokens) loads from a file or environment variable, with a clear error telling the user to re-run the browser login when it expires.
- Reproduce the headers the API actually requires — some sites 403 without a matching `user-agent`, `referer`, or `x-requested-with`.
- Keep pagination, sort, and filter parameters that appeared in the recorded query strings as function options.

## 5. Verify

Call every generated function against the live API and compare the response shape with the recording. Common failures:

| Symptom | Cause | Fix |
|---------|-------|-----|
| 401/403 | Expired or missing session | Re-login via agent-browser, re-export cookies |
| 403/419 on writes | CSRF token is per-session or per-form | Fetch the token endpoint first, or keep that flow browser-driven |
| Works then breaks | Signed/expiring request params | Fall back to the browser for that step; derive the rest |
| Different shape than HAR | A/B tests or geo-dependent responses | Re-record and treat the union as optional fields |

## Caveats

- Internal APIs are unversioned and change without notice — keep the HAR so the client can be re-derived.
- Respect the site's terms of service and rate limits; add delays for bulk fetching.
- HAR files contain live session credentials (cookies, tokens, POST bodies). Treat them like secrets: keep them out of version control and delete them when done.

© fcakyon · Apache-2.0 · fcakyon/claude-codex-settings

Похожие скиллы

Все скиллы по теме «Браузер и парсинг» →
chrome-automation zc277584121 Скилл chrome-automation для Claude Code управляет запущенным Chrome через CLI agent-browser. Собирает данные, кликает по элементам и запускает записи DevTools с сохранением активных сессий. CX Codex +1 4 000установок google-flights skillhq Поиск рейсов на Google Flights через автоматизацию браузера. Работает также на Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 3 100установок kernel-agent-browser kernel Скилл kernel-agent-browser настраивает работу agent-browser с облачными браузерами Kernel. Помогает обходить блокировки ботов и сохранять сессии с помощью семантических селекторов. CX Codex +1 1 300установок browser ruvnet Управляет браузером через agent-browser и снимки доступности. Сокращает контекст на 93% за счёт ссылок на элементы вместо сырого DOM. CX Codex +1 674установок actionbook-scraper actionbook Скилл actionbook-scraper генерирует и проверяет скрипты парсинга сайтов, используя проверенные селекторы из базы Actionbook. Автоматически валидирует код и исправляет ошибки. CX Codex +1 132установок sumsub-manage-client-lists sumsub Скилл sumsub-manage-client-lists создаёт и наполняет списки клиентов в песочнице Sumsub для правил KYT и сценариев верификации. Позволяет добавлять страны, email и IP-адреса через API. CX Codex +1 352установок

Из того же набора113

Весь набор →
ultralytics-branding Скилл ultralytics-branding загружает правила фирменного стиля Ultralytics: цвета, шрифты, правила логотипа и тон для PDF, презентаций, документов, email-рассылок и соцсетей. CX Codex +1 ★ 1 216звёзд репо email-design Скилл email-design для Claude Code и Codex помогает оформлять транзакционные письма приложений. Настраивает вёрстку подтверждений почты, сброса паролей и счетов под стиль продукта. CX Codex +1 ★ 1 216звёзд репо commit-creator Субагент commit-creator разбирает подготовленные к коммиту изменения, предлагает логичное разбиение и создаёт коммиты с понятными сообщениями. Работает с Claude Code и Codex. CX Codex ★ 1 216звёзд репо site-architecture Скилл site-architecture для Claude Code и Codex, который помогает спланировать или перестроить структуру сайта: иерархию страниц, навигацию, URL-паттерны, хлебные крошки и внутренние ссылки. CX Codex +1 ★ 1 216звёзд репо polar-local-environment Скилл polar-local-environment помогает запускать и обслуживать локальное окружение Polar через dev docker. Он пригодится для отладки сервисов и работы с несколькими изолированными worktree. CX Codex +1 ★ 1 216звёзд репо yolo-training Скилл yolo-training диагностирует графики обучения YOLO26 и results.csv, объясняет переобучение и низкий mAP, подсказывает, какой параметр менять. CX Codex +1 ★ 1 216звёзд репо supabase-cli Скилл учит агента управлять проектами через Supabase CLI: поднимать локальный стек, писать миграции, тестировать edge functions и генерировать типы TypeScript. CX Codex +1 ★ 1 216звёзд репо payment-testing Правило payment-testing собирает нюансы локальной проверки входа, Stripe, подписок, возвратов и backoffice. Помогает разобраться, почему тестовый сценарий ведёт себя не так, как ожидалось. CX Codex +1 ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой