Communitygithub.com

YepAPI/habilidades

Pesquisa de empresas locais e Google Maps usando YepAPI.

O que é habilidades?

Esta habilidade permite que agentes de IA realizem pesquisas de SEO local completas, utilizando os endpoints da API YepAPI. Ela automatiza a descoberta de concorrentes locais no Google Maps, extrai dados NAP (Nome, Endereço, Telefone) dos sites concorrentes, analisa palavras-chave locais com volume e dificuldade, e audita páginas em busca de sinais de SEO local. O fluxo de trabalho cobre cinco etapas principais: descoberta de concorrentes, extração de NAP, pesquisa de palavras-chave locais, auditoria na página e apresentação de resultados. É particularmente útil para agências de SEO, proprietários de negócios locais e desenvolvedores que buscam otimizar a presença online para pesquisas locais. A habilidade suporta tratamento de erros para créditos insuficientes, falhas upstream, erros de validação e limites de taxa, garantindo robustez na execução. Ideal para uso com agentes como Claude Code ou Cursor, ela transforma tarefas manuais de SEO local em workflows automatizados e repetíveis.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/local-seo

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Fluxo de Trabalho de SEO Local

Pesquisa de negócios locais usando dados do Google Maps e SERP local via endpoints da YepAPI.

Endpoints Utilizados

EndpointCustoFinalidade
POST /v1/serp/google/maps$0,01Resultados de empresas locais / Google Maps
POST /v1/scrape$0,01Extrair dados NAP de sites concorrentes
POST /v1/seo/keywords$0,15Métricas de palavras-chave locais (volume, dificuldade)
POST /v1/seo/page-audit$0,03Verificar sinais de SEO local no site do usuário

Fluxo de Trabalho

Etapa 1: Descoberta de Concorrentes Locais

Execute POST /v1/serp/google/maps com a categoria de negócio + localização.

{
  "query": "encanador em austin tx",
  "location": "us"
}

Retorna: listagens de empresas locais com avaliações, contagens de comentários, categorias, endereços.

Etapa 2: Extrair Dados NAP

Para cada concorrente, execute POST /v1/scrape no site deles.

{
  "url": "https://concorrente-encanador.com",
  "format": "markdown"
}

Extraia dados NAP (Nome, Endereço, Telefone) para comparar consistência entre as listagens.

Etapa 3: Pesquisa de Palavras-chave Locais

Execute POST /v1/seo/keywords com palavras-chave locais.

{
  "keywords": ["encanador em austin", "encanador emergência austin tx", "serviço de encanamento austin"],
  "location": "us"
}

Retorna: volume de pesquisa local, CPC, dificuldade — palavras-chave locais têm menor volume, mas maior intenção.

Etapa 4: Auditoria na Página

Execute POST /v1/seo/page-audit no site do usuário.

{
  "url": "https://exemplo-encanador.com"
}

Verifique sinais de SEO local: dados estruturados (esquema LocalBusiness), consistência NAP, palavras-chave de localização em meta tags.

Etapa 5: Apresentar Descobertas

  • Cenário de concorrentes locais (avaliações, contagens de comentários, rankings)
  • Oportunidades de palavras-chave (termos locais com volume e dificuldade)
  • Correções na página (dados estruturados ausentes, inconsistências NAP, lacunas em meta tags)

Regras

  • Inclua sempre a localização nas consultas do Maps — os resultados dependem da localização
  • A consistência NAP é crítica para SEO local — sinalize discrepâncias
  • Os resultados do Google Maps incluem avaliações, contagens de comentários e categorias — use para benchmarking de concorrentes
  • Palavras-chave locais têm menor volume, mas maior intenção — priorize o potencial de conversão

Tratamento de Erros

  • NO_CREDITS (402) — Informe ao usuário para adicionar créditos em https://yepapi.com/dashboard
  • UPSTREAM_ERROR (502) — Tente novamente uma vez; se falhar de novo, pule essa etapa e anote
  • VALIDATION_ERROR (400) — Verifique o formato da consulta; inclua a localização na string de consulta
  • RATE_LIMITED (429) — Aguarde e tente novamente; respeite o cabeçalho Retry-After

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Habilidades Relacionadas