Communitygithub.com

YepAPI/skills

Descubrimiento de palabras clave, métricas, ideas y análisis de brechas utilizando YepAPI.

¿Qué es skills?

Este skill está diseñado para investigación de palabras clave, permitiendo descubrir, evaluar y priorizar términos de búsqueda utilizando las API de YepAPI. El flujo de trabajo guía al agente desde la generación de ideas a partir de una palabra clave semilla, pasando por la expansión con términos relacionados, hasta la obtención de métricas detalladas como volumen de búsqueda, CPC (costo por clic), dificultad e intención. También incluye un análisis opcional de brechas entre dominios para identificar palabras clave que la competencia rankea, pero el usuario no. El agente puede priorizar los resultados combinando alto volumen con baja dificultad, agrupar por intención de búsqueda y detectar estacionalidades. Soporta plataformas como Claude Code y otros agentes que consuman APIs REST, optimizando las llamadas al agrupar hasta 100 palabras clave por solicitud para minimizar costos. Incluye manejo de errores para créditos insuficientes, límites de velocidad y fallos del servidor, con recomendaciones claras de reintento y notificación al usuario.

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

Preguntar en tu IA favorita

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

Documentación

Flujo de trabajo de investigación de palabras clave

Flujo de trabajo dedicado a la investigación de palabras clave: descubre, evalúa y prioriza términos utilizando los endpoints de YepAPI.

Endpoints utilizados

EndpointCostoPropósito
POST /v1/seo/keywords/ideas$0.03Sugerencias de palabras clave a partir de una palabra clave semilla
POST /v1/seo/keywords/related$0.03Palabras clave relacionadas para una palabra clave semilla
POST /v1/seo/keywords$0.15Métricas masivas de palabras clave (volumen, CPC, dificultad, intención)
POST /v1/seo/keyword-gap$0.04Análisis de brechas de palabras clave entre dos dominios

Flujo de trabajo

Paso 1: Generar ideas de palabras clave

Comienza con una palabra clave semilla. Ejecuta POST /v1/seo/keywords/ideas.

{
  "keyword": "gestión de proyectos",
  "location": "us"
}

Devuelve: sugerencias de palabras clave basadas en la semilla — ángulos de contenido y variaciones de cola larga.

Paso 2: Encontrar palabras clave relacionadas

Expande con POST /v1/seo/keywords/related.

{
  "keyword": "gestión de proyectos",
  "location": "us"
}

Devuelve: términos semánticamente relacionados — variaciones más amplias y más específicas.

Paso 3: Evaluar métricas de palabras clave

Ejecuta POST /v1/seo/keywords con todas las palabras clave candidatas.

{
  "keywords": ["software de gestión de proyectos", "herramientas de gestión de proyectos", "mejor app de gestión de proyectos"],
  "location": "us"
}

Devuelve: volumen de búsqueda, CPC, dificultad de la palabra clave, intención de búsqueda (informativa/comercial/transaccional), tendencias a 12 meses.

Paso 4: Análisis de brechas de palabras clave (opcional)

Si el usuario tiene un dominio y un competidor, ejecuta POST /v1/seo/keyword-gap.

{
  "domain": "ejemplo.com",
  "competitor": "competidor.com"
}

Devuelve: palabras clave para las que el competidor rankea y el usuario no — oportunidades no aprovechadas.

Paso 5: Priorizar palabras clave

Presenta una lista de palabras clave priorizadas ordenadas por puntuación de oportunidad:

  • Alta oportunidad — alto volumen + baja dificultad
  • Agrupar por intención — informativa, navegacional, comercial, transaccional
  • Marcar palabras clave estacionales — observar patrones de 12 meses a partir de los datos de tendencias

Reglas

  • Comienza amplio con ideas, luego reduce con métricas
  • Agrupa palabras clave por intención de búsqueda: informativa, navegacional, comercial, transaccional
  • Marca palabras clave estacionales usando datos de tendencias (patrón de 12 meses)
  • Realiza llamadas masivas de métricas de palabras clave — hasta 100 palabras clave por solicitud ($0.15) es más económico que consultas individuales

Manejo de errores

  • NO_CREDITS (402) — Indica al usuario que añada créditos en https://yepapi.com/dashboard
  • UPSTREAM_ERROR (502) — Reintenta una vez; si falla de nuevo, salta ese paso y anótalo
  • VALIDATION_ERROR (400) — Verifica el formato de la palabra clave; las palabras clave deben ser cadenas no vacías
  • RATE_LIMITED (429) — Espera y reintenta; respeta la cabecera 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

Local business and Google Maps research using YepAPI.

YepAPI/skills

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

YepAPI/skills

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

Skills relacionados