Communitygithub.com

Varnan-Tech/opendirectory

利用 Google Trends 数据进行博客生成的 SEO 关键词研究工作流。适用于撰写博客、规划内容日历或优化文章以提升搜索引擎排名的场景。该技能可发现爆发式关键词、构建内容结构,并生成面向技术/开发者受众的 SEO 优化博客大纲。

opendirectory 是什么?

这是一款面向 AI 编程助手(如 Claude Code、Cursor、Codex)的 SEO 关键词研究技能,专为技术博客/开发者内容生成而设计。其核心理念是**在撰写博客内容之前**进行关键词研究,从而避免“随意写文、盲目等待排名”的低效做法。该技能通过调用 Google Trends API(SERPAPI)来发现爆发式关键词(Breakout Keywords)、高增长关键词(+100% 等)以及长尾问题型关键词,并根据优先级系统(爆发式 > 高增长 > 长尾)为用户自动选择主要关键词。 工作流包含三个步骤:关键词发现(获取 RELATED_QUERIES)、内容结构生成(获取 RELATED_TOPICS)以及可选的趋势验证(TIMESERIES),最终输出一个包含标题、元描述、H2/H3 标题和关键词放置规则的 SEO 优化博客大纲。该技能支持通过 SerpApi 的免费套餐(每月 250 次搜索),并建议每次博客生成默认使用 2 次 API 调用(RELATED_QUERIES + RELATED_TOPICS),以平衡成本与效果。通过该技能,用户可以快速将泛泛的主题转化为有排名潜力的内容,适合内容营销人员、技术博主以及需要系统化 SEO 工作流的 AI 用户。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

SEO 关键词研究技能

在撰写博客内容之前发现趋势性强、机会高的关键词。本技能将通用的博客主题转化为可排名的 SEO 优化内容。

何时使用

  • 用户要求撰写博客文章或短文
  • 用户需要某个主题的关键词研究
  • 用户需要内容日历或内容计划
  • 用户希望优化现有内容的 SEO
  • 任何面向技术/开发者受众的博客生成任务

核心原则

在生成博客内容之前,始终先研究关键词。

错误:写博客 -> 希望它排名 -> 通常不会
正确:研究关键词 -> 发现爆发机会 -> 写优化博客 -> 排名良好

关键词优先级系统

分析 Google Trends RELATED_QUERIES 结果时,按以下顺序确定关键词优先级:

1. 爆发式关键词 — 最高优先级

  • formatted_value: "Breakout" = 5000%+ 增长
  • 竞争非常低(趋势新颖)
  • 用作主要博客关键词
  • 立即创建内容(先发优势)

2. 高增长关键词 — 非常高优先级

  • formatted_value: "+100%" 或更高
  • 竞争低至中等
  • 用作主要或强有力的次要关键词
  • 在 2-4 周内创建内容

3. 中等增长关键词 — 高优先级

  • formatted_value: "+50%" 至 "+99%"
  • 竞争中等
  • 用作正文中的次要关键词

4. 长尾关键词 — 战略优先级

  • 基于问题的查询(how、what、why、when、where)
  • 竞争低,转化率高
  • 用作 H3 标题 — 针对精选片段和语音搜索

5. 成熟关键词 — 中等优先级

  • 热度稳定的热门查询,竞争高
  • 用于正文内容,不作为主要目标

SEO 研究工作流

步骤 1:关键词发现(需要 1 次 API 调用 — 必需)

使用用户的博客主题查询 RELATED_QUERIES:

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

从响应中提取:

  • 爆发式关键词 → 候选主要关键词
  • 高增长关键词(+100%) → 次要候选
  • 基于问题的查询 → H3 标题和精选片段目标

选择主要关键词:

  1. 第一个爆发式关键词(若有)
  2. 否则第一个高增长关键词
  3. 否则根据得分最高的热门查询

步骤 2:内容结构(需要 1 次 API 调用 — 必需)

使用相同主题查询 RELATED_TOPICS:

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

从上升结果和热门结果中提取主题标题。这些将成为你的 H2 章节标题(选择 3-5 个)。

步骤 3:趋势验证(需要 1 次 API 调用 — 可选)

仅在多个候选关键词之间选择或验证可行性时使用:

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

比较最近 2 个月的平均值与之前 2 个月的平均值。如果最近平均值更高,则趋势上升 — 继续。如果下降,考虑其他关键词。

步骤 4:生成博客大纲

使用以下结构构建大纲:

标题:[主要关键词] — [优势/数字] [年份]
  (最多 60 个字符,必须包含主要关键词)

元描述:(150-160 个字符,包含主要关键词和 1-2 个次要关键词)

# [H1 — 与标题相同或略有变化]

## 引言(150 字)
  - 前 100 字内包含主要关键词
  - 用问题或痛点吸引读者
  - 预览他们将学到什么

## [H2:来自步骤 2 的相关主题 1]
### [H3:来自步骤 1 的长尾问题]
  回答问题的内容(150-200 字)
### [H3:另一个长尾问题]
  内容(150-200 字)

## [H2:相关主题 2]
### [H3:长尾问题]
### [H3:长尾问题]

## [H2:相关主题 3]
### [H3:长尾问题]
### [H3:长尾问题]

## 结论(100 字)
  - 总结关键点
  - 主要关键词提及一次
  - 行动号召

目标:总计 1500-2500 字

关键词放置规则

位置规则
标题包含主要关键词,最多 60 个字符
H1与标题相同或略有变化
H2 标题(3-5 个)使用相关主题,自然语言
H3 标题(8-12 个)使用长尾关键词,问题格式
首段前 100 字内包含主要关键词
正文主要关键词密度 1-2%,次要 0.5-1%
结论主要关键词提及一次
元描述主要 + 1-2 个次要,150-160 个字符

切勿堆砌关键词。 内容必须读起来自然。谷歌会惩罚不自然的重复。

质量检查清单

在生成博客之前,确认:

  • 找到至少 1 个爆发式或 +100% 关键词(或合理使用成熟关键词)
  • 从 RELATED_TOPICS 中获得 3-5 个 H2 主题
  • 为 H3 标题准备了长尾关键词
  • 主要关键词具体到足以排名
  • 博客结构遵循上述大纲模板
  • 已编写元描述(150-160 个字符)
  • 目标长度为 1500-2500 字

如果该主题不存在爆发式或高增长关键词,则告知用户 SEO 机会有限,并建议其他有增长的替代角度或相关主题。

预算意识

免费套餐:每月 250 次搜索

策略每次博客调用次数每月容量
最小化(推荐)2125 篇博客
标准383 篇博客
完整462 篇博客

默认使用 2 次调用(RELATED_QUERIES + RELATED_TOPICS)。仅在特殊需要时添加 TIMESERIES 或 GEO_MAP。

常见错误避免

  1. 跳过研究 — 不检查趋势就写文章会错过爆发机会
  2. 忽略爆发式关键词 — 在存在爆发式变体时仍使用通用词
  3. 关键词堆砌 — 不自然地重复关键词;保持密度在 1-2%
  4. 没有长尾关键词 — 错失精选片段和语音搜索机会
  5. 通用 H2 标题 — 始终使用 RELATED_TOPICS 数据进行章节结构

示例脚本

要查看完整工作示例,请运行:

python scripts/blog_seo_research.py "你的博客主题"

请参见 scripts/blog_seo_research.py 查看实现。

参考

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.

相关技能