Communitygithub.com

YepAPI/skills

Investigación de negocios locales y Google Maps utilizando YepAPI.

¿Qué es skills?

Esta habilidad permite a agentes de IA realizar investigaciones SEO locales completas utilizando la API de YepAPI. Combina la obtención de datos de Google Maps (listados de negocios, reseñas, calificaciones), el scraping de sitios web de la competencia para extraer información NAP (Nombre, Dirección, Teléfono), la investigación de palabras clave locales con métricas de volumen y dificultad, y la auditoría de páginas propias para verificar señales SEO locales como datos estructurados y consistencia NAP. Es útil para estrategas SEO locales, agencias de marketing y dueños de negocios que buscan analizar su competencia local, identificar oportunidades de palabras clave de alta intención y optimizar su presencia en búsquedas locales. Soporta la plataforma YepAPI y se integra mediante endpoints REST. El flujo de trabajo guía al agente paso a paso, desde el descubrimiento de competidores hasta la presentación de hallazgos, incluyendo manejo de errores como falta de créditos o límites de tasa.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Flujo de Trabajo SEO Local

Investigación de negocios locales utilizando datos de Google Maps y SERP local a través de los endpoints de YepAPI.

Endpoints Utilizados

EndpointCostoPropósito
POST /v1/serp/google/maps$0.01Resultados de Google Maps / negocios locales
POST /v1/scrape$0.01Extraer sitios web de competidores para datos NAP
POST /v1/seo/keywords$0.15Métricas de palabras clave locales (volumen, dificultad)
POST /v1/seo/page-audit$0.03Verificar señales SEO locales en el sitio del usuario

Flujo de Trabajo

Paso 1: Descubrimiento de Competidores Locales

Ejecuta POST /v1/serp/google/maps con categoría de negocio + ubicación.

{
  "query": "plumber in austin tx",
  "location": "us"
}

Devuelve: listados de negocios locales con calificaciones, recuento de reseñas, categorías, direcciones.

Paso 2: Extraer Datos NAP

Para cada competidor, ejecuta POST /v1/scrape en su sitio web.

{
  "url": "https://competitor-plumber.com",
  "format": "markdown"
}

Extrae los datos NAP (Nombre, Dirección, Teléfono) para comparar la consistencia entre listados.

Paso 3: Investigación de Palabras Clave Locales

Ejecuta POST /v1/seo/keywords con palabras clave locales.

{
  "keywords": ["plumber in austin", "emergency plumber austin tx", "austin plumbing service"],
  "location": "us"
}

Devuelve: volumen de búsqueda local, CPC, dificultad — las palabras clave locales tienen menor volumen pero mayor intención.

Paso 4: Auditoría en Página

Ejecuta POST /v1/seo/page-audit en el sitio del usuario.

{
  "url": "https://example-plumber.com"
}

Verifica señales SEO locales: datos estructurados (esquema LocalBusiness), consistencia NAP, palabras clave de ubicación en metaetiquetas.

Paso 5: Presentar Hallazgos

  • Panorama de competidores locales (calificaciones, recuento de reseñas, posiciones)
  • Oportunidades de palabras clave (términos locales con volumen y dificultad)
  • Correcciones en página (datos estructurados faltantes, inconsistencias NAP, brechas en metaetiquetas)

Reglas

  • Siempre incluye la ubicación en las consultas de Maps — los resultados dependen de la ubicación
  • La consistencia NAP es crítica para el SEO local — señala las discrepancias
  • Los resultados de Google Maps incluyen calificaciones, recuento de reseñas y categorías — úsalos para comparar competidores
  • Las palabras clave locales tienen menor volumen pero mayor intención — prioriza el potencial de conversión

Manejo de Errores

  • NO_CREDITS (402) — Indica al usuario que agregue créditos en https://yepapi.com/dashboard
  • UPSTREAM_ERROR (502) — Reintenta una vez; si falla de nuevo, omite ese paso y anótalo
  • VALIDATION_ERROR (400) — Verifica el formato de la consulta; incluye la ubicación en la cadena de consulta
  • RATE_LIMITED (429) — Espera y reintenta; respeta el encabezado 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.

Skills relacionados