ローカル SEO ワークフロー
YepAPI エンドポイントを介して、Google Maps とローカル SERP データを使った地域ビジネスのリサーチを行います。
使用するエンドポイント
| エンドポイント | コスト | 目的 |
|---|---|---|
POST /v1/serp/google/maps | $0.01 | Google Maps / ローカルビジネス結果の取得 |
POST /v1/scrape | $0.01 | 競合ウェブサイトの NAP データをスクレイピング |
POST /v1/seo/keywords | $0.15 | ローカルキーワード指標（ボリューム、難易度）の取得 |
POST /v1/seo/page-audit | $0.03 | ユーザーサイト上のローカル SEO シグナルをチェック |
ワークフロー
ステップ 1: ローカル競合の発見
ビジネスカテゴリ＋ロケーションで POST /v1/serp/google/maps を実行します。
{
"query": "plumber in austin tx",
"location": "us"
}
返却内容: ローカルビジネスリスト（評価、レビュー数、カテゴリ、住所）
ステップ 2: NAP データの抽出
各競合について、そのウェブサイトで POST /v1/scrape を実行します。
{
"url": "https://competitor-plumber.com",
"format": "markdown"
}
NAP（名称、住所、電話番号）データを抽出し、掲載情報間での整合性を比較します。
ステップ 3: ローカルキーワード調査
ローカルキーワードを指定して POST /v1/seo/keywords を実行します。
{
"keywords": ["plumber in austin", "emergency plumber austin tx", "austin plumbing service"],
"location": "us"
}
返却内容: ローカル検索ボリューム、CPC、難易度 — ローカルキーワードはボリュームが低いものの、意図は高いです。
ステップ 4: ページ監査
ユーザーのサイトで POST /v1/seo/page-audit を実行します。
{
"url": "https://example-plumber.com"
}
ローカル SEO シグナル（LocalBusiness スキーマによる構造化データ、NAP の整合性、メタタグ内のロケーションキーワード）をチェックします。
ステップ 5: 結果の提示
- ローカル競合の状況（評価、レビュー数、ランキング）
- キーワードの機会（ボリュームと難易度を備えたローカルキーワード）
- ページ上の修正点（構造化データの欠落、NAP の不一致、メタタグのギャップ）
ルール
- Maps クエリには常にロケーションを含める — 結果はロケーションに依存します
- NAP の整合性はローカル SEO にとって極めて重要 — 不一致を指摘します
- Google Maps の結果には評価、レビュー数、カテゴリが含まれます — 競合ベンチマークに使用します
- ローカルキーワードはボリュームが低いものの、意図は高い — コンバージョン可能性を優先します
エラーハンドリング
NO_CREDITS(402) — ユーザーに https://yepapi.com/dashboard でクレジットを追加するよう伝えますUPSTREAM_ERROR(502) — 1回リトライし、それでも失敗した場合はそのステップをスキップして記録しますVALIDATION_ERROR(400) — クエリ形式を確認し、クエリ文字列にロケーションを含めますRATE_LIMITED(429) — 待機してリトライし、Retry-Afterヘッダーを尊重します