Communitygithub.com

Varnan-Tech/opendirectory

Flujo de trabajo de investigación SEO para la generación de blogs a partir de datos de Google Trends. Útil al escribir publicaciones de blog, planificar calendarios de contenido u optimizar artículos para buscadores. Encuentra palabras clave emergentes, estructura el contenido y genera esquemas de blog optimizados para SEO, dirigidos a audiencias técnicas y de desarrolladores.

¿Qué es opendirectory?

Esta habilidad proporciona un flujo de trabajo completo de investigación de palabras clave SEO, desde el descubrimiento hasta la generación de un esquema de blog optimizado. Utiliza la API de Google Trends (a través de SerpAPI) para identificar palabras clave de alta oportunidad antes de redactar contenido, maximizando las posibilidades de posicionamiento. La habilidad prioriza palabras clave "breakout" (con crecimiento explosivo) y de alto crecimiento, y las combina con temas relacionados y preguntas de cola larga para estructurar el artículo. Está diseñada para su uso en asistentes de codificación como Claude Code, Cursor y Codex, y se ejecuta mediante llamadas API directas desde la línea de comandos. El resultado es un esquema de blog listo para redactar, con reglas de colocación de palabras clave, densidad de uso y una lista de verificación de calidad para garantizar contenido natural y efectivo. También incluye pautas de presupuesto para el uso de la API y errores comunes a evitar.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Varnan-Tech/opendirectory/tree/main/skills/google-trends-api-skills/seo-keyword-research

Preguntar en tu IA favorita

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

Documentación

Habilidad de Investigación de Palabras Clave SEO

Encuentra palabras clave de tendencia y de alta oportunidad ANTES de escribir contenido de blog. Esta habilidad convierte temas genéricos de blog en contenido optimizado para SEO que posiciona.

Cuándo Usar

  • El usuario pide escribir una publicación de blog o artículo
  • El usuario quiere investigación de palabras clave para un tema
  • El usuario necesita un calendario de contenido o un plan de contenido
  • El usuario desea optimizar contenido existente para SEO
  • Cualquier tarea de generación de blog para una audiencia técnica/de desarrolladores

Principio Clave

Siempre investiga las palabras clave ANTES de generar contenido de blog.

MAL:  Escribir blog -> Esperar que posicione -> Generalmente no lo hace
BIEN: Investigar palabras clave -> Encontrar oportunidad emergente -> Escribir blog optimizado -> Posiciona bien

Sistema de Prioridad de Palabras Clave

Al analizar los resultados de GOOGLE TRENDS RELATED_QUERIES, prioriza las palabras clave en este orden:

1. Palabras Clave Breakout (Emergentes) — Prioridad MÁXIMA

  • formatted_value: "Breakout" = crecimiento de 5000%+
  • Competencia muy baja (la tendencia es nueva)
  • Usar como palabra clave PRINCIPAL del blog
  • Crear contenido INMEDIATAMENTE (ventaja de ser el primero)

2. Palabras Clave de Alto Crecimiento — Prioridad MUY ALTA

  • formatted_value: "+100%" o superior
  • Competencia baja o moderada
  • Usar como palabra clave principal o secundaria fuerte
  • Crear contenido dentro de 2-4 semanas

3. Palabras Clave de Crecimiento Moderado — Prioridad ALTA

  • formatted_value: "+50%" a "+99%"
  • Competencia moderada
  • Usar como palabras clave secundarias en el cuerpo del contenido

4. Palabras Clave de Cola Larga — Prioridad ESTRATÉGICA

  • Consultas basadas en preguntas (cómo, qué, por qué, cuándo, dónde)
  • Competencia baja, alta conversión
  • Usar como encabezados H3 — apuntar a fragmentos destacados y búsqueda por voz

5. Palabras Clave Establecidas — Prioridad MODERADA

  • Consultas principales con interés estable, alta competencia
  • Usar en el cuerpo del contenido, no como objetivo principal

Flujo de Trabajo de Investigación SEO

Paso 1: Descubrimiento de Palabras Clave (1 llamada API — REQUERIDO)

Consulta RELATED_QUERIES con el tema del blog del usuario:

curl -s "https://serpapi.com/search?engine=google_trends&q=TEMA_USUARIO&data_type=RELATED_QUERIES&date=today+3-m&api_key=$SERPAPI_KEY"

De la respuesta, extrae:

  • Palabras clave breakout (emergentes) → candidatas a palabra clave principal
  • Palabras clave de alto crecimiento (+100%) → candidatas secundarias
  • Consultas basadas en preguntas → encabezados H3 y objetivos de fragmentos destacados

Selecciona la palabra clave principal:

  1. Primera palabra clave breakout (si existe)
  2. Si no, la primera palabra clave de alto crecimiento
  3. Si no, la consulta principal por puntuación

Paso 2: Estructura del Contenido (1 llamada API — REQUERIDO)

Consulta RELATED_TOPICS con el mismo tema:

curl -s "https://serpapi.com/search?engine=google_trends&q=TEMA_USUARIO&data_type=RELATED_TOPICS&date=today+3-m&api_key=$SERPAPI_KEY"

Extrae los títulos de los temas de los resultados ascendentes y principales. Estos se convierten en tus encabezados de sección H2 (elige 3-5).

Paso 3: Validación de Tendencias (1 llamada API — OPCIONAL)

Solo si estás eligiendo entre múltiples palabras clave candidatas o validando viabilidad:

curl -s "https://serpapi.com/search?engine=google_trends&q=PALABRA_CLAVE&data_type=TIMESERIES&date=today+12-m&api_key=$SERPAPI_KEY"

Compara el promedio de los últimos 2 meses con el promedio de los 2 meses anteriores. Si el reciente es mayor que el anterior, la tendencia está subiendo — continúa. Si está disminuyendo, considera una palabra clave diferente.

Paso 4: Generar Esquema del Blog

Construye el esquema usando esta estructura:

Título: [Palabra Clave Principal] — [Beneficio/Número] [Año]
  (máximo 60 caracteres, debe incluir la palabra clave principal)

Meta Descripción: (150-160 caracteres, palabra clave principal + 1-2 secundarias)

# [H1 — igual que el título o una variación]

## Introducción (150 palabras)
  - Palabra clave principal en las primeras 100 palabras
  - Enganche con un problema o pregunta
  - Avance de lo que aprenderán

## [H2: Tema Relacionado 1 del Paso 2]
### [H3: Pregunta de cola larga del Paso 1]
  Contenido respondiendo la pregunta (150-200 palabras)
### [H3: Otra pregunta de cola larga]
  Contenido (150-200 palabras)

## [H2: Tema Relacionado 2]
### [H3: Pregunta de cola larga]
### [H3: Pregunta de cola larga]

## [H2: Tema Relacionado 3]
### [H3: Pregunta de cola larga]
### [H3: Pregunta de cola larga]

## Conclusión (100 palabras)
  - Resumir puntos clave
  - Palabra clave principal mencionada una vez
  - Llamada a la acción

Objetivo: 1500-2500 palabras en total

Reglas de Colocación de Palabras Clave

UbicaciónRegla
TítuloIncluir palabra clave principal, máximo 60 caracteres
H1Igual que el título o variación ligera
Encabezados H2 (3-5)Usar temas relacionados, lenguaje natural
Encabezados H3 (8-12)Usar palabras clave de cola larga, formato de pregunta
Primer párrafoPalabra clave principal en las primeras 100 palabras
Cuerpo del contenidoDensidad de palabra clave principal 1-2%, secundaria 0.5-1%
ConclusiónPalabra clave principal una vez
Meta descripciónPalabra clave principal + 1-2 secundarias, 150-160 caracteres

Nunca hagas keyword stuffing. El contenido debe leerse de forma natural. Google penaliza la repetición antinatural.

Lista de Verificación de Calidad

Antes de generar el blog, verifica:

  • Se encontró al menos 1 palabra clave breakout o +100% (o se justificó el uso de una palabra clave establecida)
  • Se tienen 3-5 temas H2 de RELATED_TOPICS
  • Se tienen palabras clave de cola larga para encabezados H3
  • La palabra clave principal es lo suficientemente específica para posicionar
  • La estructura del blog sigue la plantilla de esquema anterior
  • La meta descripción está escrita (150-160 caracteres)
  • La longitud objetivo es de 1500-2500 palabras

Si no existen palabras clave breakout o de alto crecimiento para el tema, informa al usuario que la oportunidad SEO es limitada y sugiere ángulos alternativos o temas relacionados que sí tengan crecimiento.

Conciencia de Presupuesto

Nivel gratuito: 250 búsquedas/mes

EstrategiaLlamadas/BlogCapacidad Mensual
Mínima (recomendada)2125 blogs
Estándar383 blogs
Completa462 blogs

Por defecto, usa 2 llamadas (RELATED_QUERIES + RELATED_TOPICS). Solo añade TIMESERIES o GEO_MAP cuando sea específicamente necesario.

Errores Comunes a Evitar

  1. Saltarse la investigación — escribir sin verificar tendencias pierde oportunidades breakout
  2. Ignorar palabras clave breakout — usar un término genérico cuando existe una variante breakout
  3. Keyword stuffing — repetir palabras clave de forma antinatural; mantener densidad al 1-2%
  4. Sin palabras clave de cola larga — perder oportunidades de fragmentos destacados y búsqueda por voz
  5. Encabezados H2 genéricos — usar siempre datos de RELATED_TOPICS para la estructura de secciones

Script de Ejemplo

Para un ejemplo funcional completo, ejecuta:

python scripts/blog_seo_research.py "el tema de tu blog"

Consulta scripts/blog_seo_research.py para la implementación.

Referencias

Individual skills in this repo

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

Varnan-Tech/opendirectory

Use when the user asks to generate a blog cover image, thumbnail, or article header. Automatically uses modern typography, brand logos, and Google Search grounding to create beautiful 16:9 images with Gemini 3.1 Flash Image Preview.

Varnan-Tech/opendirectory

World-class brand strategist and naming expert. Uses an interrogation-led discovery phase to extract your brand's DNA, then applies scientific naming frameworks (Phonosemantics) and automated multi-TLD domain checking.

Varnan-Tech/opendirectory

Use when the user asks to generate or update a project's CLAUDE or AGENTS context file from a codebase scan. Writes a focused file under 100 lines containing only the non-obvious build commands, conventions, and gotchas Claude Code needs.

Varnan-Tech/opendirectory

Use when the user wants to verify cold emails, enrich a lead list, or autonomously guess email addresses from a CSV using ValidEmail.co or the open-source Reacher engine.

Varnan-Tech/opendirectory

Competitive intelligence orchestrator tracking companies across 8+ platforms (GitHub, Twitter, Reddit, HN, PH, YC Jobs) with heat scores and AI briefings.

Varnan-Tech/opendirectory

Give it your product URL or description. It finds your top 5 competitors, runs three-track PR research across all of them (editorial, podcasts, communities), identifies which channels appear most frequently, looks up the journalist or host for each, and returns a tiered outreach list with story angles and ready-to-send cold pitch drafts tailored to your product. Use when asked to find PR opportunities, discover where competitors got featured, build a media outreach list, find which journalists cover my space, or get pitch templates for press coverage.

Varnan-Tech/opendirectory

Generate high-converting, deep-dive growth case studies in MDX format. Use this skill when asked to write a case study or blog post about a company's growth, tech stack, or product-led strategy. It handles the full pipeline (researching the company via Tavily, generating a 16:9 cover image, quality checking the draft, uploading assets to cloud storage, and pushing directly to the target repository).

Varnan-Tech/opendirectory

Scans your project for outdated npm, pip, Cargo, Go, or Ruby packages. Runs a CVE security audit. Fetches changelogs, summarizes breaking changes with Gemini, and opens one PR per risk group (patch, minor, major). Includes Diagnosis Mode for install conflicts. Use when asked to update dependencies, check for outdated packages, open dependency PRs, scan for package updates, audit for CVEs, or flag breaking changes in upgrades. Trigger when a user says "check for outdated packages", "update my dependencies", "open PRs for dependency updates", "scan for CVEs", or "which packages need upgrading".

Varnan-Tech/opendirectory

Generates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas, and architecture. Uses graphify to build a knowledge graph first, then writes accurate docs from it. Use when asked to write docs, generate a README, document an API, update stale docs, create an API reference from code, add an architecture section, or document a project in any language. Trigger when a user says their docs are missing, outdated, or wants to document their codebase without writing it manually.

Varnan-Tech/opendirectory

Evaluates expired domain candidates against a target niche, scores them by topical relevance, historical activity level, and history cleanliness, then outputs a ranked shortlist with explainable reasoning and risk flags.

Varnan-Tech/opendirectory

Brutally honest developer-experience audit for a GitHub repo. Scores 10 DX dimensions (time-to-first-success, README clarity, visual proof, install, quick-start, docs, examples, community, trust, marketing), writes a shareable roast in the requested tone (brutal/honest/kind), produces a prioritized action plan ranked by impact × effort, and sketches an ideal README. Trigger when user says "roast my repo", "audit my README", "dx audit", "developer experience review", "score my GitHub project", "before launch checklist", or "make my repo shareable".

Varnan-Tech/opendirectory

Drafts and designs a complete HTML email newsletter from a topic or content brief. Outputs paste-ready HTML for Loops, Mailchimp, Beehiiv, Resend, or any standard email platform. Includes subject line options and plain-text fallback. Trigger when a user says "write a newsletter", "draft an email newsletter", "create an HTML email", "design an email for my subscribers", or "write a newsletter about [topic]".

Varnan-Tech/opendirectory

Takes a GitHub PR URL or the current branch and writes a plain-English explanation of what it does and why, then posts it as a PR comment. Use when asked to explain a PR, summarize a pull request, write a plain-English description of a PR, add a summary comment to a PR, or understand what a PR changes. Trigger when a user says "explain this PR", "summarize this pull request", "what does this PR do", "add a comment explaining the PR", or shares a GitHub PR URL and asks what it does.

Varnan-Tech/opendirectory

Audit how often LLMs recommend your brand vs competitors and generate a GEO action plan.

Varnan-Tech/opendirectory

Takes a competitor's public GitHub repo URL, fetches their open issues via the GitHub REST API, filters noise locally, clusters issues into 6 demand categories, computes a demand score per issue and per cluster, and outputs a ranked demand gap report with a GTM messaging brief. Use when asked to scan a competitor's GitHub issues, find what their users are begging for, turn GitHub complaints into product positioning, identify competitor feature gaps, or generate messaging from real user demand. Trigger when a user says "scan competitor issues", "what are users asking for on X repo", "find demand gaps in Y", "turn GitHub issues into messaging", or "what should I build based on competitor complaints".

Varnan-Tech/opendirectory

Find recurring confusion in your repo's GitHub Discussions, rank it by urgency, and draft the actual docs fixes and content angles — with verbatim community quotes and source links as evidence.

Varnan-Tech/opendirectory

Generates a professionally designed case study PDF for B2B SaaS sales and marketing. Supports 7 page layouts, 9 style presets, 1-4 page output. Trigger when user says "create a case study", "write a customer story", "make a case study PDF", "design a success story", "turn this customer win into a PDF".

Varnan-Tech/opendirectory

Generates data visualization charts (bar, line, area, pie, doughnut, scatter, radar, treemap) as PNG using Apache ECharts v6. 1080×1080px default, 5 style presets, highlight annotations. Trigger when user says "create a chart", "visualize data", "make a bar chart", "line graph", "pie chart", "data visualization", "chart this data", "plot", "graph", or "visualize these numbers".

Varnan-Tech/opendirectory

Creates professionally designed B2B SaaS e-books in HTML + CSS, exported as print-ready PDF. 3–10 pages, 9 style presets, 11 page layout types. Trigger when user says "create an ebook", "design a lead magnet", "make a PDF guide", "build a gated content piece", "write a B2B ebook", "design a white paper", "create a nurture asset", or "make a PDF report".

Varnan-Tech/opendirectory

Fetches low-star App Store and Google Play reviews, clusters them into broken-promise patterns, and generates a ranked copy brief with positioning opportunities.

Skills relacionados