Fornecido por DataForSEO
Obter a distribuição atual das posições de uma empresa no Google e a estimativa de tráfego (DataForSEO)
Obter uma única linha de resumo para um domínio em uma localização e idioma: como suas posições no Google se distribuem pelas faixas de classificação, seu tráfego orgânico e pago mensal estimado e quantas palavras-chave são novas, subiram, caíram ou foram perdidas. Um domínio de entrada, uma linha de saída; os domínios são resumidos um de cada vez. Uma solicitação por chamada, com preço definido pela própria tabela de tarifas do fornecedor; um conjunto de resultados vazio é informado como nenhum resultado. location_code e language_code devem formar um par da lista locations_and_languages do Labs da DataForSEO, na qual cada localização especifica os códigos de idioma aceitos; um código fora dessa lista é rejeitado com Invalid Field (observado: o código de idioma simples zh).
Como executar
Etapa 1Configurar
Uma vez: cole isto no chat do seu agente. O Skill instala a CLI e faz login sozinho. Para um agente que não pode usar um shell, conecte-o pelo MCP.
set up https://glasser.ai/SKILL.md
Show me how to use the DataForSEO endpoint /v3/dataforseo_labs/google/domain_rank_overview/live on Glasser.glasser run -p dataforseo -e '/v3/dataforseo_labs/google/domain_rank_overview/live' -i '{"target":"dataforseo.com","language_code":"en","location_code":2840}' --endpoint-version 7Usa a versão 7 do endpoint. Consulte o preço atual antes de executar. Instale e faça login primeiro em Get Started.
Uma vez por Run:
IDEMPOTENCY_KEY=$(uuidgen)Execute e copie este mesmo bloco para enviá-lo novamente:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"dataforseo","endpoint":"/v3/dataforseo_labs/google/domain_rank_overview/live","input":{"target":"dataforseo.com","language_code":"en","location_code":2840},"endpoint_version":7}'Reutilize a mesma Idempotency-Key para enviar novamente: o segundo envio é uma leitura do primeiro Run. Uma nova chave cria um novo Run e um novo Charge. Usa a versão 7 do endpoint; consulte o preço atual antes de executar.
Etapa 2Experimente uma tarefa de exemplo específica
Quando precisar analisar o desempenho de SEO de um domínio, você pode reunir as métricas disponíveis em um panorama para suas notas de pesquisa.
Copie este prompt no seu agente para preparar um panorama de SEO do seu domínio.
Use dataforseo:/v3/dataforseo_labs/google/domain_rank_overview/live on Glasser.
Pull returned SEO metrics for my domain into a research snapshot.Estrutura do endpoint
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"target"
],
"properties": {
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"offset": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"target": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_code": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_name": {
"type": "string"
},
"location_code": {
"type": "integer"
},
"location_name": {
"type": "string"
},
"ignore_synonyms": {
"type": "boolean"
}
},
"additionalProperties": false
}{
"target": "dataforseo.com",
"language_code": "en",
"location_code": 2840
}Este endpoint não publica um esquema de saída. Você recebe o corpo da resposta do próprio provedor de dados, sem alterações — não garantimos um formato que não podemos assegurar.
Como funciona a cobrança
| Taxa básica | O mesmo preço com ou sem dados correspondentes. | $0.012 |
|---|---|---|
| Por linha | Para cada linha retornado. | $0.00012 |
| Máximo por Run | A cobrança total não excederá este valor. | $0.132 |
| Erro do provedor de dados | O provedor de dados não conseguiu responder. | $0.00 |
| Tempo limite excedido | O Run excedeu seu limite de tempo. | $0.00 |
| Falha interna | Um erro interno impediu a conclusão. | $0.00 |