Criei 8 APIs de scraping pagas que agentes de IA podem chamar diretamente

Há algumas semanas, publiquei um conjunto de Atores na Apify Store. Hoje, todos eles estão prontos para agentes de IA: qualquer agente LLM (Claude, GPT, Cursor, LangChain, n8n) pode descobrir e chamá-los através do servidor Apify MCP — sem necessidade de código de integração personalizado.

Este post é o manual completo: o que as ferramentas fazem, como funciona a monetização por evento, os bugs que encontrei e como os agentes de IA realmente os consomem.

A caixa de ferramentas

Os dois gratuitos são iscas deliberadas — mais sobre isso abaixo.

Por que "pronto para agentes de IA" muda tudo

O modelo antigo: um humano encontra seu scraper na loja, lê a documentação, clica em botões.

O novo modelo: um agente de IA recebe uma tarefa ("encontre 50 encanadores em Austin com seus números de telefone"), pesquisa na Apify Store via MCP, lê o README do ator e o esquema de entrada, e o chama — do início ao fim, sem humano.

Para que isso funcione, três coisas devem ser verdadeiras:

1. Seu README é escrito para um LLM, não apenas para humanos. O meu agora começa todos com uma seção "Use esta ferramenta quando..." — é isso que o agente usa para fazer correspondência com o pedido do usuário.
2. Seu esquema de entrada tem uma descrição em cada campo. O agente constrói a entrada JSON a partir dessas descrições. Sem descrição = parâmetros alucinatórios = execuções falhadas = sem receita.
3. Seu output é documentado campo a campo. O agente precisa saber o que recebe de volta para raciocinar sobre isso.

Aqui está o fluxo real com o servidor Apify MCP (https://mcp.apify.com — adicione-o ao Claude Desktop ou Cursor em 30 segundos):

Usuário: "Me dê as contagens de seguidores desses 5 criadores do TikTok"
Agente: → search-actors("tiktok profile")
       → fetch-actor-details (lê README + esquema de entrada)
       → call-actor(travelmonitorlab/tiktok-scraper,
                    {"profiles": [...], "maxVideosPerProfile": 0})
       → retorna JSON estruturado

Ou pule o MCP completamente — cada ator é uma única chamada HTTP síncrona:

curl -X POST "https://api.apify.com/v2/acts/travelmonitorlab~google-maps-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries": ["plumbers Austin TX"], "maxResults": 50}'

Monetização: pago por evento (e a armadilha que me custou horas)

A Apify oferece vários modelos de preços. Para novos atores, PRICE_PER_DATASET_ITEM é rejeitado — você deve usar PAY_PER_EVENT. O modelo é melhor de qualquer forma: você define eventos (por exemplo, business-scraped a $0.005) e cobra explicitamente no código:

await Actor.charge(event_name="business-scraped")
await Actor.push_data(item)

A armadilha: coloque a cobrança DEPOIS de crawler.run() e seu loop de eventos pode já estar fechado — a cobrança desaparece silenciosamente, você entrega dados de graça. Cobrar dentro do manipulador, bem antes de enviar os dados. Sempre verifique com chargedEventCounts no objeto de execução após uma execução de teste.

Definir preços é pura API:

PUT /v2/acts/{actorId}
{"pricingInfos": [{
  "pricingModel": "PAY_PER_EVENT",
  "reasonForChange": "Lançamento de preços",
  "pricingPerEvent": {"actorChargeEvents": {"business-scraped": {"eventTitle": "Negócio extraído",
      "eventDescription": "Um registro de negócio do Google Maps",
      "eventPriceUsd": 0.005
    }}}}