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

fetch · brightdata — скилл для Claude Code: что делает и как установить

Скилл fetch для Claude Code забирает контент одной веб-страницы в виде Markdown, HTML или скриншота. Обходит защиту от ботов и статус 403 через Bright Data Web Unlocker.

MIT 186 установок ★ 272 обновлён 2026-10-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add brightdata/skills --skill fetch -a claude-code
Открыть на GitHub

Что делает fetch

Инструмент загружает содержимое конкретного URL и возвращает его как Markdown, исходный HTML или скриншот PNG. Запросы проходят через сервис Web Unlocker с ротацией IP, подбором отпечатков браузера, автоматическим решением капчи и повторными попытками.

Для запуска через терминал используется утилита bdata scrape <url>, где Markdown отдаётся по умолчанию. Утилите требуется рабочая зона разблокировки вроде cli_unlocker или agent_unlocker. Если CLI не установлен, вызов выполняется обычным REST-запросом к https://api.brightdata.com/request с ключом BRIGHTDATA_API_KEY.

Принудительный рендеринг JavaScript не поддерживается в CLI и настраивается только через REST с параметром render. Относительные ссылки в полученном Markdown сохраняются без изменений.

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

  • загрузить статью в формате Markdown в контекст модели
  • обойти ошибку 403 и капчу при чтении веб-страницы
  • сохранить скриншот страницы в PNG
  • получить исходный HTML страницы без ручного парсинга

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

  • Сохрани статью с https://example.com/article в формате markdown
  • Сделай скриншот страницы https://example.com/article
  • Загрузи чистый HTML страницы по адресу https://example.com/article

Как установить fetch

1Через Skills CLI (Vercel)

npx skills add brightdata/skills --skill fetch -a claude-code

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

~/.claude/skills/fetch/SKILL.md

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

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

Вопросы о fetch

Как установить fetch в Claude Code?

Выполните npx skills add brightdata/skills --skill fetch -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/fetch/SKILL.md.

Что делает fetch?

Скилл скачивает одну страницу по переданному адресу и возвращает её текст в Markdown, сырой HTML или скриншот. Встроенный обход блокировок решает капчи и устраняет ошибки 403.

Что нужно для работы fetch?

Нужна утилита bdata в PATH либо ключ доступа BRIGHTDATA_API_KEY для вызовов REST API. На аккаунте также должна быть настроена зона разблокировки, например cli_unlocker или agent_unlocker.

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

SKILL.md · MIT
---
name: fetch
description: 'Use when the user wants one known URL returned as content: "get me this page", read this article, this page as markdown, save the raw HTML, screenshot this page, or page text for a RAG index or model context. Also when a plain fetch of a URL came back blocked or challenged instead of the real page: a 403 or another error status, a CAPTCHA, a bot wall, or an empty body. Wraps Bright Data Web Unlocker, so a blocked page still comes back. Not records or many pages of data from a site (use scrape), not a search query with no URL (use search), not driving a browser with your own Playwright, Puppeteer or Selenium code (use browser), not cost or credits (use billing), not auth or KYC failures (use agent-onboarding).'
---

# Bright Data - Fetch

One URL in, one page out, as markdown, HTML, or a screenshot. Nothing is parsed for you.

Every request is unblocked: IP rotation, browser fingerprints, cookies, CAPTCHA solving and automatic retries, from a country you choose. JavaScript rendering can be forced with the REST body's `render` parameter. The CLI has no flag for it, so a CLI fetch cannot force rendering (a `-f screenshot` is still an image of the rendered page).

## The call

**CLI.** The command is `bdata scrape`, which runs Web Unlocker.

```
bdata scrape https://example.com/article
```

Markdown is the default. A first `bdata login` tries to create `cli_unlocker` and, when no default is set, stores it as the zone default, so a fresh login on a normal account needs no `--zone`. It never overwrites a default you already set. A key from agent registration cannot create zones and its account has no `cli_unlocker`, so run `bdata config set default_zone_unlocker agent_unlocker` once. An account set up any other way carries its unlocker zone under another name (`agent_unlocker` from agent registration, `mcp_unlocker` from the MCP server, any name at all when a person made it by hand): find it by the entry whose `"type"` is `"unblocker"` in `bdata zones --json`, and pass that name. Override with `--zone <name>`, or `BRIGHTDATA_UNLOCKER_ZONE`, or `bdata config set default_zone_unlocker <name>`.

If `bdata` is not recognized, the CLI is not installed or npm's global directory is not on PATH; both fixes live in the `agent-onboarding` skill's Install section.

**REST.** The same request, for any machine with no CLI.

```
POST https://api.brightdata.com/request
     Authorization: Bearer $BRIGHTDATA_API_KEY
     Content-Type: application/json

     {"zone":"cli_unlocker","url":"https://example.com/article",
      "format":"raw","data_format":"markdown"}
```

`cli_unlocker` is the name after `bdata login`. On any other account use the name of your `unblocker` zone, as above.

`format` is the envelope and `data_format` is the page. `"format":"raw"` returns the body itself, `"format":"json"` wraps it with status and headers.

For code the user keeps, the SDK wraps this same call in one line: `const html = await client.scrapeUrl('https://example.com/article')`. The `brightdata-sdk` skill owns that surface. The `scrape` skill's `references/web-unlocker.md` covers the same one-POST shape and the KYC error codes. The full parameter list, including `render`, `country` and `method`, is in Bright Data's Web Unlocker API docs.

## Formats

| Want | CLI | REST body | Note |
|---|---|---|---|
| Markdown (default) | `-f markdown` | `"format":"raw","data_format":"markdown"` | For a model, an index, or a human |
| Raw HTML | `-f html` | `"format":"raw"`, no `data_format` | When the user's own code parses it |
| Screenshot | `-f screenshot` | `"format":"raw","data_format":"screenshot"` | Binary PNG. The CLI writes `screenshot.png` unless `-o <path>` says otherwise |
| Response metadata | `-f json` | `"format":"json"` | Status and headers around the body |

One honest note on the markdown: links come back exactly as the page wrote them, so a relative link like `/pricing` stays relative and points nowhere once the text leaves the site. That is fine when the output feeds a model, an index or a RAG store. For a standalone document a person will read and click, resolve the links against the page URL first, and say that you did.

The other flags that exist: `--country <code>`, `--async`, `-o <path>`, `--json`, `--pretty`, `--timing`, and `--mobile`, which has no effect in the current CLI release.

## Example - one blocked article

The ask: *"my script gets a 403 on this URL, I just need the article text"*

1. One URL, and the page itself is the answer. Stay in this skill.
2. The 403 is the reason to be here, not a problem to route around. Unblocking is the product.
3. Text for a human or a model, so markdown, which is already the default.

```
bdata scrape https://www.example-news.com/2026/08/some-article
```

Then state the choice in one line the user can override with one word:

> Fetched the page with Web Unlocker as markdown. Say `fields` if you want the data fields pulled out instead, and I will use a maintained scraper.

## When a fetch is refused

Read the error first. A 403 from the target site is not on this list, because that is the ordinary case this skill exists to solve.

| The message contains | What it means |
|---|---|
| `No Web Unlocker zone specified.` | No zone resolved. Take the name of the `"type":"unblocker"` entry in `bdata zones --json` and pass it as `--zone`, or save it once with `bdata config set default_zone_unlocker <name>`. Do not log in again: it replaces the stored key. |
| `zone "<name>" not found` | The resolved zone does not exist on this account, often `cli_unlocker` on an account made by agent registration. Take the `"type":"unblocker"` entry from `bdata zones --json` and save it with `bdata config set default_zone_unlocker <name>`. |

Two other refusals are not this skill's to fix. A missing or dead key (`No API key found`, or 401) means the machine is not logged in. A few targets need KYC on the account before Bright Data will serve them: sites that block themselves in robots.txt such as Reddit, government sites, sites on Bright Data's blocked list, and targets its compliance policy does not permit. Most sites need none of this. Both belong to the `agent-onboarding` skill, which carries the exact error codes. Send the user there, and never send anyone to KYC before a call has actually been refused.

## Handoff boundaries

| The ask | Skill |
|---|---|
| Data fields, or many pages of one site | `scrape` |
| The same site fetched twice with a parser in between | `scrape`, because that is a scraper being written by hand |
| A query with no URL | `search` |
| Their own browser code, pointed at an unblocked browser | `browser` |

A fetch whose real purpose is pulling data fields out of the page is a scrape ask. Hand it over.

Never promise JavaScript rendering on a CLI markdown or HTML fetch; when a page needs it, use the REST call with `"render":"true"`. Never reach for a browser or a proxy because a page returned 403. That is what this one call already handles.

© brightdata · MIT · brightdata/skills

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

Все скиллы по теме «Браузер и парсинг» →

Сначала — fetch от других авторов.

fetch browserbase Загружает HTML или JSON со статических страниц через Browserbase Fetch API без тяжёлого браузера. Выполняет быстрый парсинг и проверяет заголовки и коды ответа. CX Codex +1 3 100установок reddit-fetch ykdojo Скилл reddit-fetch для Claude Code достаёт посты и комментарии Reddit через JSON API, обходя 403 на автоматических запросах. CX Codex +1 ★ 10 363звёзд репо firecrawl-download firecrawl Скилл firecrawl-download выкачивает веб-сайт или его разделы в локальные файлы markdown и скриншоты. Помогает подготовить офлайн-документацию для работы агента. CX Codex +1 80 500установок qiaomu-markdown-proxy joeseesun Скилл qiaomu-markdown-proxy преобразует веб-страницы, статьи WeChat, документы Feishu и файлы PDF в чистый Markdown перед передачей текста другим агентам. CX Codex +1 663установок HTML to Markdown MCP Server sunshad0w MCP-сервер HTML to Markdown MCP Server для Claude Code превращает веб-страницы в чистый Markdown, удаляя скрипты, стили и навигацию. Передаёт агенту статьи и документацию без лишнего мусора. CX Codex +1 ★ 5звёзд репо browser-screenshot-diff ruvnet Скилл browser-screenshot-diff для Claude Code сравнивает скриншоты и DOM двух записанных браузерных сессий на одинаковых шагах, выявляя первое расхождение и общую похожесть. CX Codex +1 697установок fetch-tweet OpusGameLabs Скилл fetch-tweet извлекает текст публикации, медиафайлы и счётчики реакций из X без рендеринга JavaScript. Скилл запрашивает данные напрямую через публичный API fxtwitter по ссылке на твит. CX Codex +1 901установок

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

Весь набор →
brightdata-sdk Скилл brightdata-sdk для Claude Code помогает писать код на Python и Node.js для скрапинга страниц и SERP, Web Unlocker и Scraper Studio. Он помогает повторять задачи в репозитории. CX Codex +1 466установок data-feeds Скилл data-feeds для Claude Code и других агентов: достаёт структурированные данные с известных сайтов через готовые скраперы Bright Data. Возвращает чистый JSON без написания парсера. CX Codex +1 425установок scraper-builder Скилл scraper-builder ведёт от «хочу данные с сайта X» до рабочего скрапера: разбор страницы, выбор API Bright Data, селекторы, пагинация. CX Codex +1 415установок design-mirror Скилл design-mirror для Claude Code снимает визуальные особенности сайта по URL и переносит их в существующий код, чтобы интерфейс повторял стиль страницы. CX Codex +1 353установок billing Скилл billing для Claude Code и Codex помогает узнать баланс аккаунта Bright Data, траты по зонам и рассчитать примерную стоимость задач. CX Codex +1 185установок brightdata-mcp Скилл brightdata-mcp для Claude Code помогает подключить инструменты Bright Data через MCP и выбрать, какие из них открыть агенту. Он включается при настройке MCP-клиента или правил выбора инструментов. CX Codex +1 184установок browser Скилл browser подключает существующие браузерные сценарии к облачной инфраструктуре. Он перенаправляет трафик драйверов типа Playwright, Puppeteer или Selenium через удалённый прокси-сервер. CX Codex +1 183установок instagram Собирает данные профилей, публикаций, Reels и комментариев Instagram в JSON. Запускается на запросы о подписчиках аккаунта, лайках или последних публикациях. CX Codex +1 182установок

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

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