--- title: "Crie Web Scrapers a partir de um Prompt com Kiro e Bright Data" slug: web-scrapers-with-kiro-power date: 2026-06-29T07:57:21+00:00 modified: 2026-06-29T07:57:21+00:00 permalink: https://brightdata.com.br/blog/ai/web-scrapers-with-kiro-power type: blog --- [ Blog ](https://brightdata.com.br/blog "Blog") / [AI](https://brightdata.com.br/blog/ai) [AI](https://brightdata.com.br/blog/ai) # Crie Web Scrapers a partir de um Prompt com Kiro e Bright Data Crie web scrapers a partir de prompts com o Kiro Power da Bright Data. 33 min de leitura [ ![Satyam Tripathi](https://media.brightdata.com.br/2024/09/Satyam-Tripathi-50x50.png) ](https://brightdata.com/blog/authors/satyam-tripathi) [Satyam Tripathi Technical Writer ](https://brightdata.com/blog/authors/satyam-tripathi) ![Kiro Power with Bright Data](https://media.brightdata.com.br/2026/06/kiro-bright-data-web-mcp.png) Um web scraper para de funcionar quando um site altera sua marcação ou começa a bloqueá-lo. O [`brightdata-scrape` Kiro Power](https://github.com/brightdata/kiro-powers/tree/main/brightdata-scrape) escreve um a partir de um prompt em linguagem simples e o executa no [Bright Data MCP da Bright Data](/ai/mcp-server), que cuida do desbloqueio e do parsing. Este guia aplica um padrão de Power repetível em 4 casos de uso, levando 2 deles até uma execução ao vivo na API, incluindo um que verifica se o ChatGPT menciona sua marca. ### TL;DR Ao final, você terá um padrão de Power que pode ser aplicado a 4 casos de uso, cada um orientado por um prompt em linguagem simples, com 2 levados até uma execução ao vivo na API: - **Rastreador de preços no varejo**, acompanha um produto na Amazon e no Walmart. - **Monitor de visibilidade de marca**, verifica quais assistentes de IA mencionam sua marca. - **Pipeline de geração de leads no LinkedIn**, monitora uma lista de prospects em busca de mudanças de emprego. - **Dashboard de inteligência do Crunchbase**, coleta dezenas de campos em tempo real por empresa. ![Agente Kiro: search_engine e depois scrape_as_markdown retornam um preço ao vivo do Sony WH-1000XM5 na Amazon de $248,00 com status de estoque. 0,9 créditos.](https://media.brightdata.com.br/2026/06/kiro-bright-data-1.png)*O agente Kiro faz 2 chamadas de ferramentas ao vivo, search\_engine e depois scrape\_as\_markdown, e retorna um preço real da Amazon de $248.* ### O que é um Kiro Power? Kiro é a IDE de IA desenvolvida pela AWS. Um Power é o formato de extensão próprio do Kiro: uma pasta que contém um manifesto, uma configuração de servidor MCP, arquivos de direcionamento e modelos de código. O Kiro carrega um Power no contexto apenas quando seu prompt o ativa. Navegue pelo [catálogo oficial em kiro.dev/powers](https://kiro.dev/powers). A Bright Data publica o `brightdata-scrape` separadamente no GitHub, para que você possa importá-lo diretamente. Os Powers diferem das Claude Skills de uma forma importante: cada Power vem com uma configuração de servidor MCP (Model Context Protocol) já definida. Assim, o agente obtém novas ferramentas para chamar, não apenas instruções. Para o `brightdata-scrape`, esse servidor é o Bright Data MCP da Bright Data. Esse endpoint oferece Web Unlocker, API SERP, Browser API e o catálogo de conjuntos de dados pré-construídos da Bright Data. O MCP da Bright Data permite que o agente use qualquer um deles em uma única chamada de ferramenta. Essas ferramentas (`search_engine`, `scrape_as_markdown`, as 50 ferramentas Pro `web_data_*`, `scraping_browser_*` e `discover`) substituem o que antes eram 3 integrações separadas — um proxy, uma API SERP e um farm de navegadores — por um conjunto de credenciais e um padrão de retry. ### Instale o Kiro Power brightdata-scrape São 5 etapas para configurar o projeto e confirmar a conexão: 1. **Obtenha um token de API da Bright Data.** Em **[Usuários e chaves de API](/cp/setting/users) → Chaves de API**, adicione uma chave com permissão de **Usuário**, defina uma expiração e copie o valor. Não é necessário cartão de crédito para o plano gratuito. 2. **Instale o Kiro, depois crie e abra o projeto.** Baixe e instale o [Kiro](https://kiro.dev/downloads). O Power precisa de um projeto para funcionar, e este guia usa Next.js, então crie um e abra a pasta `price-tracker` no Kiro: npx create-next-app@latest price-tracker \\ –typescript, app, tailwind, src-dir, use-npm cd price-tracker Você não precisa instalar mais nada agora. O Kiro adiciona os pacotes necessários ao scraper gerado posteriormente, na Fase 3. 1. **Instale o Power.** Abra o painel de Powers no Kiro (o ícone na barra de atividades à esquerda). Clique em **Adicionar Power personalizado**, depois em **Importar power do GitHub** e cole esta URL: https://github.com/brightdata/kiro-powers/tree/main/brightdata-scrape ![Modal Adicionar Power personalizado do Kiro: URL do GitHub do brightdata-scrape colada no campo de entrada, com a dica 'Pressione Enter para confirmar' visível.](https://media.brightdata.com.br/2026/06/kiro-bright-data-2.png)1. **Forneça o token ao Kiro.** Ao instalar o Power, um servidor `brightdata` é adicionado ao `.kiro/settings/mcp.json` do seu projeto com a URL `https://mcp.brightdata.com/mcp?token=${BRIGHTDATA_API_KEY}`. **Abra esse arquivo, substitua `${BRIGHTDATA_API_KEY}` pelo token literal que você copiou na Etapa 1 e salve.** Em seguida, adicione `.kiro/settings/mcp.json` ao `.gitignore` para que o token nunca seja commitado. > **Por que o token literal e não o placeholder `${…}`?** O Kiro atualmente não expande `${VAR}` no `mcp.json` (um [problema conhecido em aberto](https://github.com/kirodotdev/Kiro/issues/5060)), então o placeholder resulta em `Connection Failed` / `HTTP 404` em vez de uma conexão. 1. **Confirme a conexão.** Reabra o painel de Servidores MCP. Após alguns segundos, `brightdata` exibe **Conectado** com `search_engine` e `scrape_as_markdown` entre suas ferramentas, que é o sinal necessário. ![Painel de Servidores MCP da IDE Kiro mostrando brightdata Conectado (5 ferramentas), após instalar o Kiro Power brightdata-scrape.](https://media.brightdata.com.br/2026/06/kiro-bright-data-3.png)Agora crie `.env.local` na raiz do projeto e coloque o mesmo token nele. Você cola o token duas vezes de propósito: a cópia em `.kiro/settings/mcp.json` (Etapa 4) conecta o *Kiro* à Bright Data durante a construção, e esta cópia é lida pelo *app gerado* quando ele é executado. ```none BRIGHTDATA_API_KEY=... # o token que você gerou acima BRIGHTDATA_UNLOCKER_ZONE=... # placeholder está bom para a build de varejo; defina antes de um caso de uso com Web Unlocker ``` Em uma conta nova, ou antes de executar um caso de uso com Web Unlocker, defina primeiro o nome da sua zona. Consulte **Defina sua zona do Web Unlocker** em *Escale todos os 4 casos de uso para produção* abaixo. Em todos os 4 casos de uso, apenas o prompt muda; o fluxo de trabalho de 4 fases permanece o mesmo. ### O fluxo de trabalho de 4 fases do Kiro (um padrão para todos os 4) O Power executa as mesmas 4 fases para cada prompt. Cada fase aguarda sua aprovação antes de continuar: 1. **Detectar e planejar.** O Power verifica o manifesto do workspace (`package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, etc.) e as dependências dentro dele. Em seguida, escolhe como integrar: se encontrar um framework web, gera uma rota de API; se encontrar um SDK de agente, gera uma ferramenta de agente; e se o projeto for uma biblioteca, gera um módulo. Ele pergunta o que fazer o scraping e quantos itens. 1. **Playbook de scraping.** O Power verifica a escada de ferramentas da Bright Data e, para cada site de destino, escolhe o melhor caminho que seu plano permite: uma **ferramenta Web Data Pro** (uma das 50 ferramentas `web_data_*` em mais de 30 plataformas, campos tipados, requer `&pro=1`) → um **[gatilho de conjunto de dados](/products/datasets)** (os mesmos dados, pesquisados periodicamente, sem necessidade de `&pro=1`) → **[Web Unlocker](/products/web-unlocker)** (proxy + parsing para sites de cauda longa) → **[Browser API](/products/scraping-browser)** (fluxos de login/clique) → **[API SERP](/products/serp-api)** (resultados de busca). ![Kiro Fase 2: conjunto de dados pré-construído escolhido para Amazon e Walmart, com o portão de confirmação 'Pronto para prosseguir para a Fase 3?'. 0,38 créditos, 1m 24s.](https://media.brightdata.com.br/2026/06/kiro-bright-data-4.png)1. **Integrar.** O Power gera os arquivos. A execução de varejo abaixo produziu 4: um módulo de scraper, uma rota de API, uma página de dashboard e uma nova seção `## Web scraping` no `README.md`. (O `.env.local` já tinha o token de API, então a Fase 3 o ignorou. Essa é a regra de segurança de arquivos: ele não sobrescreve um arquivo que já existe.) ![Chat do Kiro mostrando a Fase 3 do Power brightdata-scrape concluída: quatro arquivos escritos, zero erros de TypeScript, 1,38 créditos usados em 1m 56s.](https://media.brightdata.com.br/2026/06/kiro-bright-data-5.png)1. **MCP e verificação.** O Power mescla o servidor MCP da Bright Data no `.kiro/settings/mcp.json` e executa um teste de fumaça na URL de destino. Duas proteções de produção são executadas nesta fase: o diff-antes-de-sobrescrever e a recuperação FALHA → ITERAR. A Fase 4 do caso de uso 1 mostra a recuperação completa. ### O que foi executado ao vivo e o que é mostrado **Tudo aqui foi verificado na API ao vivo, não é uma simulação.** Os preços exatos, ferramentas e tempos vêm de execuções capturadas específicas. Como os scrapers leem dados ao vivo, seus próprios resultados refletirão preços, páginas e respostas de modelos atuais, não os capturados aqui. - **Os casos de uso 1 e 4 foram executados completamente na API ao vivo:** varejo (sem gasto Pro) e Crunchbase (no plano Pro). Cada captura de tela de varejo abaixo é dessa execução, e o código completo do caso de uso 4 está em sua seção. - **Os casos de uso 2 e 3 são mostrados, não reconstruídos:** o prompt, as ferramentas que a Fase 2 escolheria e formatos de campos cujos nomes verificamos ao vivo em cada ferramenta. Eles reutilizam o cliente `callMcpTool` do caso de uso 4, então não há código quase idêntico a re-colar. - **Os casos de uso 2, 3 e 4 são executados no modo Pro (`&pro=1`),** que é abordado em Escalar para produção abaixo. ### Caso de uso 1: rastreamento de preços em múltiplos varejistas Aqui está o prompt para o Kiro: > **Prompt para o Kiro:** *“Adicione um agente de comparação de preços que faça scraping dos preços do Sony WH-1000XM5 na Amazon e no Walmart.”* **Escolha da Fase 2**: Na execução capturada sem Pro, o Power escolheu o caminho de gatilho de conjunto de dados (mesmos dados, pesquisados periodicamente). Com `&pro=1`, ele escolheria as ferramentas Pro `web_data_amazon_product` e `web_data_walmart_product`. **Expandindo para mais varejistas**: o mesmo padrão adiciona `web_data_ebay_product`, `web_data_homedepot_products` e `web_data_bestbuy_products` ao re-solicitar ao Kiro com uma lista de varejistas mais ampla. Alguns varejistas (Best Buy, Target) geralmente precisam de domínios Premium habilitados na zona; Amazon e Walmart não precisaram na execução capturada. #### A arquitetura que o Kiro gerou O dashboard busca a API ao montar. A API chama os gatilhos de conjunto de dados da Bright Data em paralelo e retorna os registros estruturados. ```none Browser opens / │ ▼ (auto-fetch on mount) GET /api/scrape-prices │ ▼ src/scrapers/price-tracker.ts fetchAllPrices() │ ▼ (Promise.allSettled, parallel) ┌────────────────────────────────────┐ │ Bright Data Datasets API │ │ gd_l7q7dkf244hwjntr0 → Amazon │ │ gd_l95fol7l1ru6rlo116 → Walmart │ └────────────────────────────────────┘ ``` *Um caminho de leitura: dashboard → rota de API → módulo de scraper → 2 gatilhos de conjunto de dados da Bright Data. Com `&pro=1`, o módulo de scraper se torna chamadas MCP diretas de `web_data_`*, e o loop de polling do lado do cliente se move para o servidor MCP.\* #### O módulo de scraper `src/scrapers/price-tracker.ts` contém os IDs dos conjuntos de dados, um helper `triggerAndPoll` e uma etapa `normalise` que achata a resposta da Bright Data em um formato consistente `PriceResult`. Aqui está o núcleo do arquivo, e o arquivo completo tem cerca de 85 linhas: ```none // src/scrapers/price-tracker.ts (excerpt) const BASE = "https://api.brightdata.com/datasets/v3"; const DATASETS = { Amazon: "gd_l7q7dkf244hwjntr0", Walmart: "gd_l95fol7l1ru6rlo116" } as const; async function triggerAndPoll(datasetId: string, url: string) { // 1. POST trigger with the target URL const trigger = await fetch(`${BASE}/trigger?dataset_id=${datasetId}&include_errors=true`, { method: "POST", headers: { Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify([{ url }]), }); const { snapshot_id } = await trigger.json(); if (!snapshot_id) throw new Error("no snapshot_id returned from trigger"); // 2. Poll the snapshot endpoint (in-progress = HTTP 202; ~120 s cap) for (let i = 0; i < 24; i++) { await new Promise((r) => setTimeout(r, 5000)); const res = await fetch(`${BASE}/snapshot/${snapshot_id}?format=json`, { headers: { Authorization: `Bearer ${process.env.BRIGHTDATA_API_KEY}` } }); if (res.status === 202) continue; return await res.json(); } throw new Error("snapshot timed out after 120s"); } // triggers both retailers in parallel; Promise.allSettled isolates errors per retailer, // so one bad snapshot doesn't fail the other. The full file maps each settled result // into a PriceResult (rejected ones carry an `error` field). export async function fetchAllPrices() { return Promise.allSettled( Object.entries(DATASETS).map(([retailer, id]) => triggerAndPoll(id, PRODUCT_URLS[retailer]).then((r) => normalise(r[0], retailer, PRODUCT_URLS[retailer]))), ); } ``` #### O chat do Kiro é um cliente MCP ao vivo, não uma consulta de memória Durante a construção, o painel de chat do Kiro fala com o mesmo servidor `brightdata` que seu código chama. Ao ser perguntado sobre o preço do Sony, o chat não respondeu a partir da memória do modelo. Ele fez chamadas ao vivo de `search_engine` e `scrape_as_markdown` e retornou uma tabela ($195,55 recondicionado a $248 novo, mais uma comparação com o XM6 a $398): ![Chat do Kiro, execução completa: o agente escolhe search_engine e depois scrape_as_markdown por conta própria, retornando um preço ao vivo do Sony WH-1000XM5 na Amazon. 1m 24s, 0,9 créditos.](https://media.brightdata.com.br/2026/06/kiro-bright-data-6.png)*O chat é como você explora durante a construção. O dashboard abaixo é o que seus usuários finais veem.* #### O dashboard A rota inicial (`/`) que o Kiro gerou renderiza o JSON retornado pela API como 2 cartões coloridos (laranja Amazon e azul Walmart) mais um banner verde “Melhor preço” indicando o mais barato dos 2: ![A rota inicial (/) às 14:27 de 28 de maio de 2026: Sony WH-1000XM5 a $248 na Amazon e no Walmart, mostrado como cartões com um banner verde "Melhor preço" na Amazon.](https://media.brightdata.com.br/2026/06/kiro-bright-data-7.png)*A visão da rota inicial (`/`). Sony WH-1000XM5 a $248 na Amazon e no Walmart com títulos de produtos, status de estoque e carimbos de tempo por varejista lidos diretamente de cada fonte. O `in_stock` bruto do Walmart e o `In Stock` da Amazon são passados como estão, então você vê exatamente o que cada fonte retorna. Normalize para seu próprio esquema quando construir alertas sobre isso.* Se você inspecionar as páginas brutas, o seletor de preço óbvio da Amazon (`span.a-price-whole`) geralmente retorna vazio, e o real é `.a-price .a-offscreen`. O Walmart não coloca o preço no HTML renderizado; ele fica dentro de um blob JSON em `