Communitygithub.com

YepAPI キーワードリサーチスキル

YepAPI を使用してキーワードの発見、指標測定、アイデア生成、ギャップ分析を行うワークフローです。

YepAPI キーワードリサーチスキル とは?

このスキルは YepAPI のエンドポイントを活用し、SEO キーワードリサーチを体系的に実行するワークフローを提供します。主な機能は、シードキーワードからのキーワードアイデア生成、関連キーワードの拡張、ボリュームや CPC、難易度、検索意図などのバルクメトリクス取得、そして競合ドメインとのキーワードギャップ分析です。これにより、ユーザーは高機会キーワード(高ボリューム・低難易度)を優先順位付けでき、検索意図ごとにグループ化や季節性キーワードのフラグ付けも可能です。対応プラットフォームは Claude Code などの AI エージェントであり、各 API 呼び出しには明確なコストが設定されています。ワークフローは段階的に進行し、アイデアから具体化、そして最適化へと導きます。エラーハンドリングも充実しており、クレジット不足やレート制限などの一般的な問題を適切に処理します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

キーワードリサーチワークフロー

専用のキーワードリサーチワークフロー — YepAPI エンドポイントを使用してキーワードを発見、評価、優先順位付けします。

使用するエンドポイント

エンドポイント費用目的
POST /v1/seo/keywords/ideas$0.03シードキーワードからのキーワード提案
POST /v1/seo/keywords/related$0.03シードキーワードの関連キーワード
POST /v1/seo/keywords$0.15バルクキーワードメトリクス(ボリューム、CPC、難易度、意図)
POST /v1/seo/keyword-gap$0.042 つのドメイン間のキーワードギャップ分析

ワークフロー

ステップ 1: キーワードアイデアを生成する

シードキーワードから始めます。POST /v1/seo/keywords/ideas を実行します。

{
  "keyword": "project management",
  "location": "us"
}

戻り値: シードに基づくキーワード提案 — コンテンツアングルとロングテールバリエーション。

ステップ 2: 関連キーワードを見つける

POST /v1/seo/keywords/related で拡張します。

{
  "keyword": "project management",
  "location": "us"
}

戻り値: 意味的に関連する用語 — 広義および狭義のバリエーション。

ステップ 3: キーワードメトリクスを評価する

すべての候補キーワードを指定して POST /v1/seo/keywords を実行します。

{
  "keywords": ["project management software", "project management tools", "best project management app"],
  "location": "us"
}

戻り値: 検索ボリューム、CPC、キーワード難易度、検索意図(情報/商業/取引)、12 か月のトレンド。

ステップ 4: キーワードギャップ分析(オプション)

ユーザーが自社ドメインと競合ドメインを持っている場合、POST /v1/seo/keyword-gap を実行します。

{
  "domain": "example.com",
  "competitor": "competitor.com"
}

戻り値: 競合がランクインしているが自社はランクインしていないキーワード — 未開拓の機会。

ステップ 5: キーワードを優先順位付けする

機会スコアで並べ替えた優先キーワードリストを提示します:

  • 高機会 — 高ボリューム + 低難易度
  • 意図ごとにグループ化 — 情報、ナビゲーション、商業、取引
  • 季節性キーワードにフラグを付ける — トレンドデータから 12 か月のパターンを確認

ルール

  • アイデアで広く始め、次にメトリクスで絞り込む
  • キーワードを検索意図でグループ化する: 情報、ナビゲーション、商業、取引
  • トレンドデータを使用して季節性キーワードにフラグを付ける(12 か月のパターン)
  • キーワードメトリクス呼び出しはバッチ処理する — 1 リクエストあたり最大 100 キーワード($0.15)は個別ルックアップよりも安価

エラーハンドリング

  • NO_CREDITS (402) — ユーザーに https://yepapi.com/dashboard でクレジットを追加するように伝える
  • UPSTREAM_ERROR (502) — 1 回再試行する; それでも失敗した場合はそのステップをスキップして記録する
  • VALIDATION_ERROR (400) — キーワード形式を確認する; キーワードは空でない文字列である必要がある
  • RATE_LIMITED (429) — 待機して再試行する; 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.

関連スキル