# FlashData vs Serper.dev: Google Pesquisa API comparação

Compare a utilização do pacote Serper.dev com o preço do FlashData, preserve a saída da ferramenta do seu agente e crie fluxos de trabalho com pesquisa Google, legendas YouTube e entrega de mídia.

Serper.dev fatos revisados: 2026-11-10. FlashData taxas e subsídios de teste usam seus catálogos públicos atuais.

- [Recursos](#features)
- [Por que mudar?](#overview)
- [Pacotes e gastos](#costs)
- [Sua ferramenta existente](#compatibility)
- [Trocar a chamada](#migration)
- [Além da pesquisa](#workflows)
- [Implementação do agente](#agents)
- [Perguntas frequentes](#faq)

<a id="features"></a>
## Comparação de funcionalidades

Mantenha os campos de pesquisa familiares, comece com uma compra de crédito menor e adicione empregos salvos ou evidências de YouTube quando seu fluxo de trabalho precisar deles.

### Comece com um compromisso menor

| Recurso | FlashData | Serper.dev |
| --- | --- | --- |
| Compra mínima de crédito | $10 — $1.00 / 1,000 · pague conforme usar | $50.00 — $1.00 / 1,000 · Starter |
| Subsídio de pesquisa de nova conta | Até 2,000 pesquisas — Subsídio de inscrição única | 2,500 consultas gratuitas — Oferta de inscrição |
| Avaliação do agente antes da inscrição do proprietário | Sim — Até 50 Google pesquisas · 72 horas | Cadastre-se e use uma chave de conta API |

### Preserve o comportamento da sua ferramenta de pesquisa

| Recurso | FlashData | Serper.dev |
| --- | --- | --- |
| Web, imagens, notícias, compras, vídeos e lugares | Sim — Seis Google fontes | Sim — Pontos de extremidade Google correspondentes |
| Segmentação por país, idioma e local | gl, hl e localização — Parâmetros internos | gl, hl e localização — Campos de solicitação de nível superior |
| Filtros de data para notícias e pesquisas | Sim — params.tbs · por exemplo qdr:w | Sim — tbs · por exemplo qdr:w |
| Próxima página e contagem de resultados solicitada | params.page e params.num — O número da página começa em 1 | página e número — O número da página começa em 1 |
| Títulos, fonte URLs e trechos | Matriz de resultados orgânicos — título, link, snippet e posição | Matriz de resultados orgânicos — título, link, snippet e posição |
| Perguntas, respostas e contexto da entidade | Sim — As pessoas também perguntam, caixa de resposta e gráfico de conhecimento quando retornados | Sim — As pessoas também perguntam, caixa de resposta e gráfico de conhecimento quando retornados |

### Ferramentas para agentes e trabalho em segundo plano

| Recurso | FlashData | Serper.dev |
| --- | --- | --- |
| Autônomo oficial CLI | Sim — Linux, macOS e Windows · sem tempo de execução para instalar | Não informado — No catálogo público de produtos |
| Markdown resultados de pesquisa de API | Sim — Escolha o conteúdo JSON ou Markdown | JSON resultados de pesquisa |
| async trabalhos persistentes que você pode retomar até ID | Sim — Envie, salve o ID, recupere mais tarde | Não informado — O fluxo de pesquisa publicado retorna realtime resultados |
| Google consultas em um JSON envio | 100 pré-pago — Persisted Batch · up to 500 by plano | Até 100 consultas — Mini-batch retorna respostas juntas |
| Retornos de chamada de conclusão para trabalhos em segundo plano | Sim — callback_url em cada async ou consulta em lote | Não informado — No fluxo de pesquisa publicado |
| Vinculação ao titular e entrega de credenciais | Sim — Reivindique uma vez; reutilizar o perfil CLI salvo | Configure uma chave API da conta |

### Continue a partir da pesquisa em YouTube

| Recurso | FlashData | Serper.dev |
| --- | --- | --- |
| Procure metadados por YouTube vídeo ID | Sim — Metadados YouTube dedicados API | Não informado — Google pesquisa de vídeo está disponível |
| Legendas com carimbo de data/hora YouTube | Sim — Texto da legenda e tempo para evidências de vídeo | Não informado — No catálogo público de produtos |
| YouTube entrega de vídeo/áudio para seu armazenamento | Sim — YouTube Baixar API | Não informado — No catálogo público de produtos |

A compra inicial usa FlashData pré-pago e Serper Starter. Pacotes Serper maiores têm taxas unitárias mais baixas; compare-os na calculadora. A avaliação do agente é separada das ofertas de inscrição e está sujeita à elegibilidade. Não listado refere-se ao catálogo público de produtos de Serper; podem existir integrações comunitárias.

<a id="overview"></a>
## O que faria a mudança valer a pena?

Mova a parte da sua carga de trabalho que precisa mudar. Google a pesquisa orgânica pode se mover independentemente dos tipos de pesquisa especializados.

### Seu volume de pesquisa é desigual

Uma taxa de pacote baixa ajuda quando você usa as consultas. Compare a compra antecipada e o uso de seis meses com a opção pré-paga de FlashData.

[Verifique a utilização do pacote](#costs)

### Seu agente precisa de evidências de vídeo

Um resultado de vídeo Google dá a você um URL. FlashData pode continuar com metadados YouTube, legendas com carimbo de data e hora e entrega em seu armazenamento.

[Veja as tarefas completas](#workflows)

### Sua ferramenta de pesquisa faz parte de um sistema maior

Mantenha a entrada da ferramenta do agente e o formato de citação enquanto move a chamada do provedor. Adicione trabalhos persistentes quando o trabalho precisar ser retomado após o encerramento de um processo.

[Verifique sua integração](#compatibility)

<a id="costs"></a>
## Preço unitário e compra antecipada

Os pacotes Serper são compras pré-pagas, não assinaturas ou recargas de consultas mensais. Todos os pacotes listados têm validade de crédito de seis meses. FlashData oferece créditos compartilhados pré-pagos e planos mensais opcionais.

### FlashData Google Planos de pesquisa

| Plano | Por 1,000 solicitações | Mensalidade | Créditos incluídos | Google Solicitações de pesquisa |
| --- | --- | --- | --- | --- |
| Pagamento por uso | $1.00 | $0 · sem mensalidade | Nenhum | Complete conforme necessário |
| Micro | $0.80 | $49.00 | 1,000 ($50.00 de uso) | ≈ 62,500 |
| Starter | $0.65 | $199.00 | 4,000 ($200.00 de uso) | ≈ 307,692 |
| Pro | $0.60 | $499.00 | 10,000 ($500.00 de uso) | ≈ 833,333 |
| Scale | $0.50 | $999.00 | 20,000 ($1,000.00 de uso) | ≈ 2,000,000 |
| Business | $0.40 | $1,999.00 | 40,000 ($2,000.00 de uso) | ≈ 5,000,000 |

Os créditos incluídos são renovados a cada período de faturamento. Solicitar subsídios pressupõe que o saldo total compartilhado vá para Google Pesquisa.

### Serper.dev pacotes pré-pagos

| Pacote pré-pago | Por 1,000 consultas | Compra de pacote | Consultas por pacote | Mensalidade | Consultas/segundo |
| --- | --- | --- | --- | --- | --- |
| Starter | $1.00 | $50.00 | 50,000 | $0 | 50 |
| Padrão | $0.75 | $375.00 | 500,000 | $0 | 100 |
| Scale | $0.50 | $1,250.00 | 2,500,000 | $0 | 200 |
| Ultimate | $0.30 | $3,750.00 | 12,500,000 | $0 | 300 |

### Exemplo de carga de trabalho: FlashData pré-pago e Serper Starter

Selecione cada provedor de forma independente. O custo mensal de FlashData é a taxa mensal mais o uso de pesquisa acima do valor de crédito incluído. As solicitações incluídas pressupõem que todos os créditos compartilhados vão para Google Pesquisar. O menor custo mensal modelado seleciona o plano FlashData com o menor total em seu volume. O custo mensal efetivo por 1,000 é o total dividido pelas pesquisas mensais inseridas, multiplicado por 1,000. O preço unitário de Serper é a compra do pacote dividida pela contagem de consultas, multiplicada por 1,000. O valor de uso mostra os créditos consumidos; não é uma taxa de assinatura mensal. Começando sem Serper créditos, a estimativa de compra é arredondada para pacotes inteiros na taxa selecionada; as consultas não utilizadas permanecem nos pacotes adquiridos, que expiram após seis meses. A previsão do primeiro pacote assume um pacote comprado agora e o mesmo volume mensal durante seis meses: consultas usadas = min(tamanho do pacote, volume mensal × 6); custo efetivo por 1,000 = preço do pacote ÷ consultas usadas × 1,000. As compras posteriores de pacotes estão fora dessa previsão. Com zero pesquisas, nenhuma compra de pacote é necessária e o custo efetivo é indefinido. As recargas de autoatendimento FlashData começam em $10 e podem deixar um saldo credor. Créditos de avaliação, saldos existentes, impostos e outros usos API estão excluídos.

| Pesquisas / mês | FlashData custo mensal modelado | Serper valor de uso | Serper compra de pacote inteiro do zero | Consultas restantes após mês |
| --- | --- | --- | --- | --- |
| 1,000 | $1.00 | $1.00 | $50.00 | 49,000 |
| 10,000 | $10.00 | $10.00 | $50.00 | 40,000 |
| 100,000 | $100.00 | $100.00 | $100.00 | 0 |
| 1,000,000 | $1,000.00 | $1,000.00 | $1,000.00 | 0 |

Esses cenários usam a taxa de Serper Starter. Uma taxa mais baixa de um pacote maior requer a compra de um pacote maior. Use a calculadora HTML para selecionar cada plano de forma independente.

### Você usará um pacote antes que ele expire?

Suponha que um pacote seja comprado agora e o mesmo volume de pesquisa todos os meses durante seis meses. Consultas de limite usadas no tamanho do primeiro pacote; as compras posteriores de pacotes estão fora desta previsão. Divida o preço do primeiro pacote pelas consultas usadas para encontrar o custo efetivo por 1,000.

| Primeiro pacote | Pesquisas / mês | Compra de pacote | Usado dentro de seis meses | Não utilizado no vencimento | Custo efetivo / 1,000 usado |
| --- | --- | --- | --- | --- | --- |
| Starter | 1,000 | $50.00 | 6,000 | 44,000 | $8.33 |
| Padrão | 1,000 | $375.00 | 6,000 | 494,000 | $62.50 |
| Starter | 10,000 | $50.00 | 50,000 | 0 | $1.00 |
| Padrão | 10,000 | $375.00 | 60,000 | 440,000 | $6.25 |

Com zero pesquisas, nenhum pacote é necessário e o custo efetivo é indefinido. Se o primeiro pack for totalmente utilizado, o seu custo efetivo é igual à tarifa anunciada. Para um plano mensal de FlashData, calcule (taxa mensal + uso acima dos créditos incluídos) ÷ buscas mensais × 1,000; uma taxa anunciada baixa não elimina a taxa de assinatura em volume baixo.

[FlashData preços](https://flashdata.dev/pt/pricing/google-search) · [Comparação interativa](https://flashdata.dev/pt/compare/serper#costs)

### Testes de inscrição

Novas contas FlashData qualificadas podem tentar até 2,000 Google pesquisas após inscrição e verificação de e-mail, usando o balancete de teste compartilhado completo para pesquisa. Não é necessário cartão.
Serper oferece 2,500 consultas de teste gratuitas, sem necessidade de cartão. Este não é um subsídio mensal recorrente.

[FlashData teste de inscrição](https://flashdata.dev/pt/products/google-search#trial-faq)

<a id="compatibility"></a>
## Mantenha o contrato que seu agente já usa

Uma integração Serper pode retornar uma string, um dicionário ou documentos com links. Mantenha o nome da ferramenta e o esquema de entrada estáveis e adapte a resposta de FlashData dentro da ferramenta.

| Integração existente | Saída atual | O que preservar |
| --- | --- | --- |
| LangChain · GoogleSerperAPIWrapper | results() retorna um dicionário; run() combina trechos selecionados em uma string. | Verifique qual método sua cadeia chama. Retornar uma matriz onde a próxima etapa espera texto altera o contrato da ferramenta. |
| CrewAI · SerperDevTool | Aceita search_query e retorna resultados estruturados, incluindo blocos opcionais. | Mantenha search_query como entrada da ferramenta. Mapeie os campos que seu agente lê; substituir SERPER_API_KEY por si só não pode mudar de provedor. |
| Palheiro · SerperDevWebSearch | Retorna documentos e links. Os documentos contêm trechos de pesquisa. | Preserve as saídas e a fonte URLs. Retenha o componente separado de busca de conteúdo quando seu pipeline precisar de páginas inteiras. |

[Construa o adaptador de ferramenta HTTP](https://flashdata.dev/pt/docs/guides/search-in-an-app/reference.md#tool)

### Quais tipos de pesquisa podem ser movidos?

| Sua tarefa existente | Decisão de migração | FlashData fonte ou próximo passo |
| --- | --- | --- |
| Google resultados da web | Migre a chamada de pesquisa orgânica e normalize sua saída. | google_search |
| Imagens, notícias, compras, vídeos, lugares | Mapeie cada tarefa para sua fonte e analisador dedicados. | google_images, google_news, google_shopping, google_videos, google_places |
| Acadêmico, Patentes, Preenchimento Automático | Mantenha essas ligações com seu provedor existente; FlashData não possui equivalente direto em seu catálogo atual. | Sem equivalente direto |
| Texto completo de um site vinculado | Retenha a etapa de busca e extração de página após a pesquisa. | Um snippet de pesquisa não é o artigo completo |

### Mapeamento exato de solicitação e resposta

| Mudança | Serper.dev | FlashData | Nota de migração |
| --- | --- | --- | --- |
| Solicitação de pesquisa | POST /search | POST /v1/queries/realtime | Use o host de dados FlashData e fonte=google_search. |
| Chave API | X-API-KEY cabeçalho | X-API-Key cabeçalho | A caixa do cabeçalho não é a diferença. Use uma chave FlashData com permissão google_search. |
| Consulta | q | query | Renomeie o campo de solicitação. |
| País, idioma, contagem | gl, hl, num | params.gl, params.hl, params.num | Aninhar opções em parâmetros; manter seus valores. |
| Filtro de local e horário | localização, tbm | params.location, params.tbs | Preserve a segmentação usada pela sua tarefa existente. |
| Resultados orgânicos | orgânico[] | resultados[0].orgânico[] | Leia o wrapper de resposta FlashData após status=done. |
| Campos de origem | title, link, snippet, position | title, link, snippet, position | Mantenha os campos de citação da sua aplicação; normalize o link para o URL, se necessário. |
| Consultas relacionadas | relatedSearches[] | resultados[0].relatedSearches[] | Trate isso como opcional; consumir cada campo de consulta quando presente. |
| Perguntas relacionadas | peopleAlsoAsk[] | resultados[0].peopleAlsoAsk[] | Uma pergunta pode chegar sem resposta, trecho ou URL. Não presuma que todo objeto contém evidências. |
| Blocos de resposta e entidade | answerBox, knowledgeGraph | Nenhum mapeamento um-para-um garantido | Se sua ferramenta exigir esses blocos, mantenha esse caminho até que os campos obrigatórios tenham um mapeamento compatível. |
| Notícias, imagens ou lugares | Um endpoint diferente, como /news | Uma fonte dedicada como google_news | Selecione a origem e use seus próprios parâmetros e esquema de resultados. |

Mapeie apenas as opções e os blocos de resultados que sua tarefa usa. Uma pergunta relacionada opcional não é automaticamente uma pergunta respondida com uma fonte.

[FlashData Google Esquema de pesquisa](https://flashdata.dev/pt/docs/sources/google_search/reference.md)

<a id="migration"></a>
## Migrar uma pesquisa

1. Cadastre-se ou faça login em FlashData, conclua a configuração da conta e crie uma chave API com permissão google_search. Verifique os créditos disponíveis. Um agente pode reutilizar o acesso salvo ou usar o fluxo de teste qualificado abaixo.
2. Escolha Python ou Bash. Salve o script Python completo com o nome de arquivo exibido em sua pasta de tarefas antes de running. Cada bloco envia uma pesquisa; running ambas as versões consultam ambos os provedores.
3. Inspecione os registros normalizados. FlashData requer status=done antes de ler os resultados[0].orgânico. Resultados orgânicos vazios podem ser válidos. Mantenha o título, URL, snippet e posição para citações.

[Configuração da conta](https://flashdata.dev/signup) · [API chaves](https://flashdata.dev/app/api-keys) · [Créditos disponíveis](https://flashdata.dev/app/billing)

### Python

Python 3, somente biblioteca padrão. Salve o script completo com o nome de arquivo mostrado na pasta de tarefas e execute-o. Ele lê a variável de ambiente ou solicita uma chave em particular. Cada script executa uma pesquisa.

#### Serper.dev: serper-search.py

```python
import getpass, json, os
from urllib.request import Request, urlopen
from urllib.error import HTTPError, URLError

key = os.environ.get("SERPER_API_KEY")
if not key:
    key = getpass.getpass("Serper key: ")
payload = {"q": "openai", "gl": "us", "hl": "en", "num": 10}
request = Request("https://google.serper.dev/search",
    data=json.dumps(payload).encode(),
    headers={"X-API-KEY": key, "Content-Type": "application/json"})
try:
    with urlopen(request, timeout=120) as response:
        body = json.load(response)
except HTTPError as error:
    raise SystemExit(f"HTTP {error.code}; check access and request input.") from None
except (URLError, TimeoutError):
    raise SystemExit("No response; check state before retrying.") from None
if body.get("error"):
    raise SystemExit("Search failed; inspect its error before retrying.")
items = body.get("organic", [])
print(json.dumps([{
    "position": item.get("position"), "title": item.get("title"),
    "url": item.get("link"), "snippet": item.get("snippet")
} for item in items], ensure_ascii=False, indent=2))
```

Execute após salvar: `python3 serper-search.py`

#### FlashData: flashdata-search.py

```python
import getpass, json, os
from urllib.request import Request, urlopen
from urllib.error import HTTPError, URLError

key = os.environ.get("FLASHDATA_API_KEY")
if not key:
    key = getpass.getpass("FlashData key: ")
payload = {"source": "google_search", "query": "openai",
           "params": {"gl": "us", "hl": "en", "num": 10}}
request = Request("https://data.flashdata.dev/v1/queries/realtime",
    data=json.dumps(payload).encode(),
    headers={"X-API-Key": key, "Content-Type": "application/json"})
try:
    with urlopen(request, timeout=120) as response:
        body = json.load(response)
except HTTPError as error:
    raise SystemExit(f"HTTP {error.code}: check input and access.") from None
except (URLError, TimeoutError):
    raise SystemExit("No response; check state before retrying.") from None
if body.get("status") != "done":
    raise SystemExit("Search is not complete; check its status.")
items = (body.get("results") or [{}])[0].get("organic", [])
print(json.dumps([
    {"position": item.get("position"), "title": item.get("title"),
     "url": item.get("link"), "snippet": item.get("snippet")}
    for item in items
], indent=2, ensure_ascii=False))
```

Execute após salvar: `python3 flashdata-search.py`

### cURL / Bash

Bash, cURL 7.76+ e jq. Execute qualquer bloco completo em sua pasta de tarefas. Ele avisa apenas quando a variável de ambiente do provedor está faltando, salva a resposta bruta e imprime resultados normalizados. Cada bloco envia uma pesquisa.

#### Serper.dev: Serper.dev · Bash

```bash
if [ -z "${SERPER_API_KEY:-}" ]; then
  read -r -s -p "Serper key: " SERPER_API_KEY
  printf '\n'
fi
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://google.serper.dev/search' \
  --header "X-API-KEY: $SERPER_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"q":"openai","gl":"us","hl":"en","num":10}' \
  --output serper-result.json &&
jq 'if .error then error("Search failed; check the response") else
  [(.organic // [])[] | {position, title, url: .link, snippet}]
  end' serper-result.json
```

#### FlashData: FlashData · Bash

```bash
if [ -z "${FLASHDATA_API_KEY:-}" ]; then
  read -r -s -p "FlashData key: " FLASHDATA_API_KEY
  printf '\n'
fi
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"source":"google_search","query":"openai",
           "params":{"gl":"us","hl":"en","num":10}}' \
  --output flashdata-result.json &&
jq 'if .status == "done" then
  [(.results[0].organic // [])[] | {position, title, url: .link, snippet}]
  else error("Search not complete; check status before retrying") end' flashdata-result.json
```

### Formato de saída normalizado

Produção ilustrativa; os exemplos renomeiam o link para url.

```json
[
  {
    "position": 1,
    "title": "OpenAI | Research & Deployment",
    "url": "https://openai.com/",
    "snippet": "..."
  }
]
```

### Antes de mudar sua ferramenta de produção

| Caso | O que verificar |
| --- | --- |
| Pesquisas representativas | Use seu país, idioma e localização existentes. Verifique os campos obrigatórios e citações utilizáveis; não compare classificações ao vivo byte por byte. |
| Resultados vazios ou parciais | Uma lista orgânica vazia é válida. Blocos opcionais ausentes não devem se tornar respostas inventadas ou evidências não citadas. |
| Falhas de acesso e crédito | Erros de autenticação, permissão e equilíbrio de superfície. Um erro não deve parecer uma pesquisa bem-sucedida sem correspondências. |
| Limites de taxa ou resposta perdida | Use novas tentativas limitadas para um limite de taxa explícito. Inspecione o estado do trabalho salvo após um tempo limite; evite lançar um segundo provedor automaticamente para uma solicitação incerta. |

Comece com um fluxo de trabalho. Mantenha a configuração do provedor existente disponível para uma reversão deliberada; enviar todas as solicitações para ambos os provedores adiciona outra pesquisa faturável.

### Trabalho em segundo plano e recuperação

Um wrapper async Python lida com a espera dentro desse processo. Para trabalhos que devem sobreviver a uma reinicialização, envie um trabalho FlashData async persistente, salve seu ID e recupere esse trabalho mais tarde. Grupos em lote de consultas conhecidas; Processa um arquivo em massa.

[Em tempo real e async](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md) · [Lote e massa](https://flashdata.dev/pt/docs/reference/batch-and-bulk/reference.md) · [Erros](https://flashdata.dev/pt/docs/errors/reference.md)

<a id="workflows"></a>
## O que acontece depois que seu agente encontra um link?

Google Pesquisa, YouTube Dados e YouTube Download compartilham o saldo de uma conta, com taxas e permissões separadas.

### Crie um resumo de pesquisa com evidências em vídeo

Comece com: Uma empresa, produto ou pergunta de pesquisa.

1. Google Pesquisa: descubra fontes
2. YouTube Pesquisa: encontre vídeos relevantes
3. Metadados + legendas: colete evidências com carimbo de data/hora

Obtenha: Um resumo com links de origem e carimbos de data/hora do vídeo.

Mantenha a extração da página da web para artigos completos. Se um vídeo não tiver legenda, registre essa lacuna em vez de tratar o título como uma transcrição.

[Construa o fluxo de trabalho de pesquisa](https://flashdata.dev/pt/docs/guides/google-youtube-research/reference.md)

### Entregue um vídeo selecionado ao seu armazenamento

Comece com: Um vídeo YouTube selecionado pelo seu aplicativo.

1. Metadados: confirme o vídeo selecionado
2. Download: envie um trabalho de entrega
3. Armazenamento: mantenha os detalhes do objeto entregue

Obtenha: Vídeo ou áudio no armazenamento configurado, ready para o próximo trabalho.

Use o acesso do proprietário com permissão youtube_download. O acesso de teste temporário do agente não inclui download. A entrega usa seu próprio preço baseado em bytes.

[Construa o pipeline de entrega](https://flashdata.dev/pt/docs/guides/media-delivery-pipeline/reference.md)

### Enriquecer um arquivo de vídeo conhecido IDs

Comece com: Uma lista existente de YouTube vídeos IDs.

1. Prepare um arquivo de texto com um vídeo ID por linha
2. Em massa: envie uma vez e salve o trabalho ID
3. Resultados: recupere a saída e inspecione failed itens

Obtenha: Um conjunto de dados que seu aplicativo pode unir ao IDs original.

Pular Google Pesquise quando você já conhece o IDs. Persista o trabalho ID para que um processo reiniciado retome o trabalho existente.

[Processar um arquivo em massa](https://flashdata.dev/pt/docs/guides/bulk/reference.md)

<a id="agents"></a>
## Mova uma ferramenta antes de mover todo o agente

Reutilize as credenciais salvas primeiro. Use CLI para tarefas de terminal ou um host compatível com MCP para chamadas de ferramenta. Sem acesso existente, leia auth.md e o catálogo de permissões antes de iniciar uma identidade temporária elegível.

Avaliação atual do agente: 1 crédito(s), até 50 Google pesquisas, 72 horas. Este é um subsídio inicial sujeito a limites de registro e elegibilidade.

### Solicitação de migração

```text
Read https://flashdata.dev/compare/serper/reference.md and https://flashdata.dev/auth.md.
Inspect my Serper tool, including its input, country/language filters, output type and consumed fields.
Report unsupported search types or required answer/entity blocks before changing the integration.
Migrate one supported Google organic-search task; retain specialized calls and existing credentials.
Preserve the tool name, input schema, text-or-record output and source URLs.
Reuse existing FlashData access; otherwise check eligibility before starting one trial.
Keep keys in the host secret store, outside chat and source control.
Check normal, empty, missing-optional-field and error responses with local fixtures.
Run one search for "openai" with gl=us, hl=en and num=10; save the result and usage.
Do not automatically call both providers or retry an uncertain submission.
Do not buy credits. For recurring use, ask the owner to claim and approve access.
Reuse the same profile and state directory. Stop on revocation or insufficient credits.
```

### CLI: perfil padrão existente

Complete [CLI instalação e autenticação](https://flashdata.dev/pt/docs/guides/flashdata-cli/reference.md) primeiro. Estes comandos verificam o acesso, validam a solicitação e enviam uma pesquisa:

```bash
flashdata auth status --json --non-interactive &&
flashdata search "openai" --gl us --hl en --num 10 \
  --dry-run --json --non-interactive &&
flashdata search "openai" --gl us --hl en --num 10 \
  --run-id serper-migration-first --json --non-interactive
```

Para reivindicar, o proprietário faz login ou se inscreve, verifica o e-mail e aprova as permissões de origem e o uso do saldo compartilhado. Mantenha o perfil original para transferência de credenciais. Os créditos temporários não utilizados não são transferidos. O acesso reivindicado utiliza o saldo do proprietário; a reivindicação não compra créditos nem cria um limite de gastos por chave.

Para tarefas recorrentes, mantenha a credencial do proprietário salva e o diretório de estado persistente. Use uma execução ID por ocorrência agendada e a mesma ID ao recuperar essa ocorrência. O CLI pode reutilizar um resultado completed somente enquanto seu estado salvo permanecer disponível. Uma ferramenta HTTP precisa de seu próprio estado persistente; o CLI run ID não é um cabeçalho de idempotência API. Pare com acesso revogado ou créditos insuficientes. Não registre testes de substituição nem compre créditos automaticamente.

[Acesso do agente](https://flashdata.dev/auth.md) · [Reivindicando](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md) · [Codex](https://flashdata.dev/pt/docs/integrations/codex/reference.md) · [OpenClaw](https://flashdata.dev/pt/docs/integrations/openclaw/reference.md) · [Tarefas recorrentes](https://flashdata.dev/pt/docs/guides/recurring-tasks/reference.md)

<a id="faq"></a>
## Perguntas frequentes

### Já comprei um pacote de Serper. Tenho que mover tudo?

Não. Mova primeiro uma tarefa suportada e retenha outras chamadas enquanto usa seu pacote existente. Serper créditos não são transferidos para FlashData. Mantenha credenciais de provedor separadas e encaminhe cada tarefa deliberadamente.

### Qual preço devo comparar: a tarifa do pacote ou o custo das consultas que utilizo?

Use ambos. A tarifa do pacote pressupõe que você consuma o pacote inteiro; a previsão de utilização mostra o que acontecerá se você não fizer isso. Para uma assinatura de FlashData, compare a taxa mensal e o uso incluído com seu volume real, não apenas com sua taxa unitária mais baixa.

### A alteração de SERPER_API_KEY mudará minha ferramenta de agente existente?

Uma ferramenta específica do Serper ainda chama o endpoint do Serper e analisa sua resposta. Substitua a chamada do provedor, use uma tecla FlashData e adapte a resposta à mesma saída da ferramenta. Uma conexão MCP é uma opção de integração separada, não um valor de substituição para essa variável de ambiente.

### Todos os resultados e blocos de pesquisa avançados serão idênticos?

Os resultados ao vivo podem diferir em ordem e conteúdo. Migre os campos que seu aplicativo realmente consome. Título orgânico, URL, snippet e posição têm um mapeamento claro; respostas opcionais e blocos de entidade precisam de seu próprio mapeamento antes de você mudar esse caminho.

### Um método async Python me dá um trabalho retomável?

Um método cliente async permite que seu processo faça outro trabalho enquanto espera por uma resposta. Um trabalho FlashData async persistente tem um trabalho ID que você pode salvar e recuperar mais tarde. Use o último quando o trabalho precisar sobreviver a uma reinicialização do processo e mantenha esse ID antes de agendar outro envio.

### Um saldo significa o mesmo preço para pesquisas, legendas e downloads?

Não. Os produtos compartilham créditos, mas têm taxas, unidades de cobrança e permissões separadas. Uma pesquisa Google é cobrada como uma solicitação de pesquisa; a entrega de mídia usa preços baseados em bytes. Aprove as permissões de proprietário necessárias antes de adicionar um novo produto a um fluxo de trabalho recorrente.

### Quando manter Serper é a escolha mais simples?

Quando sua ferramenta existente já faz todo o trabalho, você usa seu pacote pré-pago dentro de sua validade ou conta com Scholar, Patents, Autocomplete ou campos específicos do provedor sem equivalente em FlashData. Você pode manter essas chamadas e usar FlashData para os fluxos de trabalho adicionais necessários.

[HTML comparação](https://flashdata.dev/pt/compare/serper)
