sales-openwebninja

OpenWeb Ninja プラットフォームのヘルプ

Website Contacts Scraper や Email Search から、Local Business Data、Real-Time Web Search、JSearch、Product Data API、Web Unblocker などまで、OpenWeb Ninja プラットフォームに関する質問に対応します。OpenWeb Ninja は Sunnyvale を拠点とするリアルタイム公開データ API スタックで、30 以上の API、5 万人以上のサブスクライバー、月間 1 兆件以上のリクエスト、G2 での評価 4.8／5 を誇ります。各 API は独立した製品で、それぞれ固有のサブスクリプション、エンドポイント、レート制限があり、app.openwebninja.com ポータルまたは RapidAPI マーケットプレイスから利用できます。

ステップ 1 — 状況を確認する

references/learnings.md が存在する場合は、蓄積された知識を確認するため、最初に読みます。

ユーザーに次の質問をします。

1. OpenWeb Ninja のどの分野についてサポートが必要ですか？

   • A) Website Contacts Scraper — 任意のウェブサイトのドメインからメールアドレス、電話番号、ソーシャルリンクを抽出する
   • B) Email Search — 検索クエリから公開されているメールアドレスを見つける
   • C) Local Business Data — 40 以上の項目（電話番号、ウェブサイト、評価、レビュー、営業時間、メールアドレス、ソーシャルリンク）で Google マップのビジネスを検索する
   • D) Social Links Search — 企業や個人のソーシャルメディアプロフィールを見つける
   • E) Real-Time Web Search — Google SERP の結果（オーガニック検索、AI Overviews、AI Mode、動画、場所、ニュース、ナレッジグラフ）
   • F) JSearch — 求人情報アグリゲーター（LinkedIn、Indeed、Glassdoor、ZipRecruiter — 2 億件以上の求人情報）
   • G) Product Data APIs — Amazon、eBay、Walmart、Costco の商品データ（350 億件以上の掲載情報）
   • H) Web Unblocker — ローテーションプロキシを使って、任意のウェブサイトからレンダリング済み HTML を取得する
   • I) Finance Data — 株式、暗号資産、外国為替のリアルタイムデータ
   • J) AI/LLM APIs — ウェブアクセス機能を備えた Google AI Mode、Gemini、ChatGPT、Copilot
   • K) その他の API — Zillow、Yelp、Trustpilot、イベント、Waze、Local Rank Tracker、書籍、フォーラム、ショート動画、画像検索、ニュース
   • L) アカウント／請求 — プラン、料金、API サブスクリプション
   • M) その他 — 内容を説明してください

2. あなたの役割は何ですか？

   • A) 営業／SDR／BDR
   • B) RevOps／営業オペレーション
   • C) 開発者／エンジニア
   • D) グロース／マーケティング
   • E) リクルーター／採用担当者
   • F) その他

3. 何を実現しようとしていますか？（具体的な目標や質問を説明してください）

ユーザーの依頼ですでにこれらの状況がほぼ把握できている場合は、該当するステップに直接進んでください。 合理的な前提を明示したうえで、最善の回答をまず提示します。その後、最後に最も重要な確認質問を 1～2 個だけ尋ねます。状況を完全に把握するまで回答を保留しないでください。

注：ユーザーに専門的なスキルが必要な場合は、そのスキルのほうが適している理由を簡潔に説明し、案内してください。

ステップ 2 — 案内するか、直接回答する

依頼が専門的なスキルに該当する場合は、次のように案内します。

• 複数プラットフォームにまたがるエンリッチメント戦略／複数ツールによるエンリッチメント -> /sales-enrich
• 見込み客リストの作成戦略 -> /sales-prospect-list
• ミドルウェアを介した OpenWeb Ninja と他のツールとの接続 -> /sales-integration
• Lobstr に関する質問 -> /sales-lobstr
• Outscraper に関する質問 -> /sales-outscraper
• Apollo に関する質問 -> /sales-apollo

それ以外の場合は、以下のリファレンスに基づき、プラットフォームの知識を使って直接回答します。

ステップ 3 — OpenWeb Ninja プラットフォームのリファレンス

詳細なモジュールのドキュメント、料金、連携、データモデルについては、references/platform-guide.md を読んでください。

プラットフォームガイドの詳細を確認する必要はありません。ユーザー固有の状況に集中してください。

ステップ 4 — 実用的なガイダンス

ユーザーの具体的な質問に基づいて、以下を行います。

1. 対象企業のウェブサイト一覧から連絡先を抽出する場合：

   1. Website Contacts Scraper API に各対象ドメインを指定し、メールアドレス、電話番号、ソーシャルリンクを抽出します
   2. ドメインごとの応答時間は0.5～3秒です。大量のリストを処理する場合は、リクエストをバッチ処理し、レート制限を守ってください（Freeでは1リクエスト/秒、Megaでは最大30リクエスト/秒）
   3. 結果はウェブサイトが公開している情報に左右されます。複数のメールアドレスや電話番号が返されるドメインもあれば、何も返されないドメインもあります
   4. 連絡先が返されないドメインについては、Email Search API で補完します。会社名で検索し、必要に応じてドメインで絞り込めます
   5. Social Links Search を使って、見つかった連絡先の LinkedIn、Twitter、Facebook のプロフィールを補完します
   6. カスタム API 統合を通じて結果を CRM にエクスポートします。OpenWeb Ninja に標準の CRM コネクターはないため、ミドルウェア（Zapier、Make、n8n）を使うか、直接統合を構築してください
   7. アウトリーチの前に、別のメール検証サービスで見つかったメールアドレスを確認します（OpenWeb Ninja にメール検証機能は含まれていません）

2. Google Maps から地域の企業見込み客リストを作成する場合：

   1. Local Business Data API を使って、カテゴリと場所で検索します（例：「オースティン（TX）の歯科医」）
   2. 返される企業1件ごとに別々のリクエストとしてカウントされます。20件の企業を返す検索では、割り当てから20リクエストが消費されます
   3. 各企業について、電話番号、ウェブサイト、メールアドレス、住所、評価、レビュー数、営業時間、ソーシャルリンクなど、40項目以上のフィールドを取得できます
   4. 地理的な半径を指定する検索には近隣検索を、より広い地域を対象にする場合は一括検索を使います
   5. 優先度の高い対象についてはレビューを取得し、課題を把握してアウトリーチを個別に調整します
   6. Website Contacts Scraper を使って結果を補完し、Google Maps に掲載されていないメールアドレスを追加します
   7. 結果をスプレッドシートまたは CRM にエクスポートします。簡単なスクリプトを作成するか、ミドルウェアを使ってデータを整形し、送信します

3. ウェブ検索 API で競合情報を収集する場合：

   1. Real-Time Web Search API に競合他社名、製品名、または業界キーワードを指定します
   2. クエリごとに最大500件の結果を取得できます。市場固有の情報を得るには、地域と言語を指定します
   3. SERP の機能を解析します。AI Overviews で競争上の位置付けの要約を、People Also Ask で購入者によくある質問を、ナレッジグラフで企業情報を取得します
   4. ニュースの結果を監視して、競合他社の発表、資金調達、製品の発売を把握します
   5. JSearch で求人情報を追跡し、競合他社の採用パターン（事業拡大の兆候、技術スタックの変化）を特定します
   6. Product Data APIs と組み合わせて、EC 競合他社の価格情報を収集します
   7. API 呼び出しを定期的にスケジュールし、経時的な変化を追跡することで、自動監視を設定します

注意点

調査に基づくベストエフォートの情報です。特に API ごとのサブスクリプションや料金に関する項目は変更されている可能性があるため、確認してください。

1. API ごとに個別のサブスクリプションが必要なため、複数の API を使うと費用がかさみます。 OpenWeb Ninja は単一のプラットフォームサブスクリプションではありません。Website Contacts Scraper、Local Business Data、Email Search が必要な場合は、サブスクリプションが3つ必要です。3つすべてに Pro を契約すると、月額25ドルではなく75ドルかかります。契約前に本当に必要な API を確認し、使用頻度の低い API には従量課金（1リクエストあたり0.001～0.005ドル）を検討してください。

2. 無料プランの利用枠は非常に限られており（50～500リクエスト）、API によって異なるため、評価専用です。 利用枠は API ごとに異なります。Website Contacts、Email Search、Social Links は月50回、Real-Time Web Search と Web Unblocker は月100回、JSearch は月200回、Local Business Data は月500回です。無料プランのレート制限も API ごとに異なります。一部の API は毎秒1リクエスト、ほかの API（Email Search、Local Business Data、JSearch）は毎時1,000リクエストです。本番環境での使用には適していません。テストで利用する場合は、必ず各 API の無料プランの利用枠を確認してください。

3. レート制限はプランごとだけでなく、APIごとにも異なります。一律の制限だと思い込まないでください。 あるAPIのProプランでは1秒あたり5件まででも、別のAPIのProプランでは1秒あたり10件までの場合があります。複数のAPIを連携する場合は、APIごとにレート制限を個別に管理する必要があります。レート制限を超えると、リクエストがキューに追加されるのではなく、エラーが返されます。

4. Local Business Dataの利用数は、検索クエリ単位ではなく、返されたビジネスの件数で数えられます。 20件のビジネスを返す検索を1回実行すると、クォータを20リクエスト分消費します。広い地域を対象にした検索や幅広いカテゴリーでの検索では、月間の割り当てをすぐに使い切る可能性があります。リクエスト消費を抑えるには、具体的なカテゴリーと範囲を絞った地域フィルターを使用してください。一括処理中は、使用状況ダッシュボードをこまめに確認してください。

5. Web Unblockerが返すのは構造化データではなく生のHTMLです。自分で解析する必要があります。 構造化されたJSONを返す他のAPIとは異なり、Web Unblockerはページ全体のレンダリング済みHTMLを返します。有用なデータを抽出するには、独自の解析ロジック（BeautifulSoup、Cheerioなど）が必要です。対象データに対応している場合は、構造化API（Local Business Data、Product Dataなど）を使用してください。Web Unblockerは、専用APIが対応していないサイト向けの代替手段です。

6. RapidAPIと直接ポータルでは料金が異なる場合があります。登録前に比較してください。 OpenWeb Ninja APIは、app.openwebninja.comポータルとRapidAPIマーケットプレイスの両方で利用できます。料金、レート制限、プランの階層は、両方のプラットフォームで同一とは限りません。費用を重視する場合は、契約前に両方の料金を比較してください。認証方法はアクセス方法によって異なります。直接ポータルでは、https://api.openwebninja.com/{api-name}/...に対してx-api-key: YOUR_API_KEYヘッダーを使用します（2026-06-13に確認済み）。RapidAPIでは、独自のX-RapidAPI-KeyヘッダーとRapidAPIのホストルーティングを使用します。

7. ネイティブのCRM連携機能はありません。OpenWeb NinjaはAPI専用です。 HubSpotやSalesforceとのコネクターが組み込まれたプラットフォームとは異なり、OpenWeb NinjaからCRM、スプレッドシート、その他のツールにデータを送信するには、独自の連携開発が必要です。ミドルウェアプラットフォーム（Zapier、Make、n8n）を使用するか、APIを直接連携してください。導入にかかる総コストを評価する際は、この開発工数も考慮してください。

8. Email Searchが返すのは公開インデックスに登録されたメールアドレスのみで、検証済みではありません。 Email Search APIは、ウェブ上で公開されているメールアドレスを見つけます。これらのメールアドレスは到達可能性が検証されておらず、古い情報である場合や、info@、support@などの役割ベースのアドレスが含まれる場合があります。見つかったメールアドレスをアウトリーチに使用する前に、必ず別の検証サービスで確認してください。より網羅的に情報を得るには、Website Contacts Scraperと組み合わせてください。

9. エンドポイントによって応答時間は大きく異なります。連携を計画する際は、その点を考慮してください。 Website Contacts Scraperはリクエストごとに0.5～3秒、Email Searchは1～2秒かかりますが、Web Unblocker（JavaScriptレンダリングを使用する場合）やLocal Business Data（詳細情報をすべて取得する場合）はさらに時間がかかることがあります。大量データを処理するパイプラインでは、同期リクエストを連鎖させるのではなく、非同期処理とキューイングを実装してください。応答時間のばらつきを考慮し、タイムアウトは余裕を持たせて（10秒以上）設定してください。

• 自己改善：ここに記載されていない情報を見つけた場合は、今日の日付を添えてreferences/learnings.mdに追記してください。

ステップ5 — 関連スキル

• /sales-enrich — クロスプラットフォームのデータ拡充戦略（複数ツールによるデータ拡充ワークフロー、ウォーターフォール型のデータ拡充）
• /sales-prospect-list — 見込み客リストの作成戦略とベストプラクティス
• /sales-integration — OpenWeb NinjaをCRM、自動化ツール、その他のプラットフォームに接続
• /sales-lobstr — Lobstrプラットフォームのヘルプ（ウェブスクレイピングとデータ抽出）
• /sales-outscraper — Outscraperプラットフォームのヘルプ（Google Mapsのスクレイピングとビジネスデータ）
• /sales-apollo — Apolloプラットフォームのヘルプ（B2Bデータベースと営業エンゲージメント）
• /sales-do — どのスキルを使うべきかわからない場合は、ルーターが営業に関するあらゆる目的に応じて適切なスキルを選びます。インストール：npx skills add sales-skills/sales --skill sales-do

例

例1：Google Maps から見込み客リストを作成し、地域営業のアプローチに活用する

ユーザーの発言：「営業チームが電話できるように、アリゾナ州フェニックスにある配管会社をすべて、電話番号とウェブサイト付きで探したいです。」 スキルの動作：

1. Local Business Data API を使用して、アリゾナ州フェニックスで「plumbing」関連の事業者を検索します
2. 取得した事業者はそれぞれ個別のリクエストとしてカウントされることを説明します。50社の配管会社が見つかった場合、月間クォータから50リクエストが消費されます
3. 各事業者について、事業者名、電話番号、ウェブサイト、住所、評価、レビュー数、営業時間などの主要な項目を抽出します
4. 営業電話をかける価値のある、実績のある事業者に絞るため、評価（例：星3つ以上）とレビュー数（例：10件以上）でフィルタリングすることを推奨します
5. 各事業者のウェブサイトに Website Contacts Scraper を使用し、Google Maps に掲載されていないメールアドレスやソーシャルメディアへのリンクを補足します
6. 簡単なスクリプトまたはミドルウェアを使って、スプレッドシートまたは CRM にエクスポートすることを推奨します。ネイティブの CRM 連携はありません
7. 予算への影響を明記します：事業者50社＋ウェブサイトの連絡先スクレイピング50件＝2つの API にまたがる100リクエストです 結果：営業活動ですぐに活用できるよう、電話番号、ウェブサイト、メールアドレス、評価、レビュー情報を含む、フェニックスの配管会社の構造化されたリストを作成できます

例2：ウェブサイトから連絡先情報を取得し、ターゲットアカウントリストを拡充する

ユーザーの発言：「メールアドレスとソーシャルメディアへのリンクを取得したい会社のドメインが200件あります。どのように設定すればよいですか？」 スキルの動作：

1. ドメインの連絡先情報を一括抽出するために、Website Contacts Scraper API を推奨します。200件のドメインを1件あたり0.5～3秒で処理するため、合計で約2～10分かかります
2. レート制限の要件を確認します：無料プランでは1秒あたり1件まで（200件のドメインでは最低約3.5分）、Pro では1秒あたり5～10件（200件のドメインでは約20～40秒）です
3. リトライや追加の検索にも余裕を持たせるため、200件のドメインに対応できる最小限の実用的なプランとして、Pro プラン（月額$25、10,000～20,000リクエスト）を推奨します
4. コードのパターンを提示します：ドメインを順に処理してそれぞれ API を呼び出し、メールアドレス、電話番号、ソーシャルメディアへのリンクを収集し、エラーや空のレスポンスに対応します
5. 連絡先情報が見つからなかったドメインについては、会社名を指定して Email Search API にフォールバックします。この API は別途契約が必要です
6. 結果の統合方法を説明します：Website Contacts Scraper の結果と Email Search の結果を結合し、メールアドレスを基準に重複を排除します
7. 検出されたメールアドレスは検証済みではないことを説明し、営業連絡の前にメールアドレス検証サービスを利用することを推奨します 結果：連絡先データを使って200件のドメインを拡充するための計画とコードの実装方針に加え、明確な予算の見通しとフォールバック戦略を用意できます

例3：営業活動のシグナルとして、競合他社の求人情報をモニタリングする

ユーザーの発言：「競合他社が新しいエンジニア職の求人を掲載したタイミングを追跡したいです。新製品を開発している可能性があり、こちらから競合提案をする際の手がかりになるかもしれません。」 スキルの動作：

1. JSearch API を使用し、企業名で求人情報を検索してエンジニア職に絞り込みます。LinkedIn、Indeed、Glassdoor、ZipRecruiter の情報（掲載数は2億件以上）を集約します
2. 定期検索のパターンを設定します：競合他社を毎週検索し、前週の結果と比較して新しい求人を特定します
3. 求人情報の説明文を解析し、技術関連のキーワード、チーム規模の指標、製品分野への言及を抽出します
4. Real-Time Web Search API でプレスリリース、ブログ記事、ニュース記事を検索し、競合他社の製品方針に関する情報を補足します
5. Job Salary Data API を使用して、新たに採用する人材の職位と予算の水準を把握します
6. データベースまたはスプレッドシートに結果を保存し、異常値（採用の急増、新しい技術スタックへの言及、新しいオフィス所在地など）にフラグを付けることを推奨します
7. これには2つの API（JSearch と Real-Time Web Search）の個別契約が必要なため、それに応じて予算を確保する必要があります 結果：求人情報を製品戦略や営業戦略の先行指標として活用する、自動化された競合情報収集ワークフローを構築できます

トラブルシューティング

Website Contacts Scraper が既知の企業に対して空の結果を返す

症状：よく知られた企業のドメインを指定して Website Contacts Scraper を呼び出しても、メールアドレス、電話番号、ソーシャルリンクが返されません。 原因：企業のウェブサイトに連絡先情報が目立つように掲載されていない、プレーンテキストのメールアドレスではなく JavaScript で描画される問い合わせフォームを使用している、難読化されたメールアドレス形式（例：「name [at] company [dot] com」）を使用している、または最近ウェブサイトをリニューアルした可能性があります。企業によっては、公開ページに直接の連絡先情報を意図的に掲載していません。 解決策：代替手段として Email Search API を試してください。企業のウェブサイトだけでなく、より広範なウェブを検索します。ドメインが別の URL（例：www の有無、または親会社のドメイン）にリダイレクトされていないか確認してください。Social Links Search を試してソーシャルプロフィールを見つけてください。連絡先情報が掲載されている場合があります。JavaScript を多用する企業では、Web Unblocker API を使うと Website Contacts Scraper が取得できないコンテンツを取得できる場合がありますが、HTML はご自身で解析する必要があります。

Local Business Data に重複または古い事業者が含まれる

症状：検索結果に、同じ事業者の重複エントリー（異なる場所 ID）や、閉業した事業者が含まれます。 原因：事業者が複数のリスティング（例：異なる部門、古いリスティングと新しいリスティング）を持つ場合、Google Maps のデータに重複が含まれることがあります。閉業した事業者も、「完全閉業」のステータスを確認する必要がある状態で Google Maps のデータに残っている場合があります。 解決策：事業者名だけでなく、電話番号や住所で結果を重複排除してください（フランチャイズでは同じ名前が使われています）。「完全閉業」または「一時休業」のステータスフィールドがある事業者を除外してください。事業者のウェブサイト（Website Contacts Scraper 経由）と照合し、現在も営業しているか確認してください。価値の高い見込み客リストでは、一斉に連絡する前に、結果の一部を手作業で確認してください。

複数の API で発生するレート制限エラー

症状：パイプラインで複数の OpenWeb Ninja API を呼び出すと、429（リクエストが多すぎます）エラーが発生します。 原因：各 API のレート制限はそれぞれ独立していますが、同じ統合環境から複数の API を連続してすばやく呼び出すと、1 つ以上の API の制限を超えることがあります。レート制限は API ごと、プランごとに設定されており、Free は 1 回／秒、Pro は 5～10 回／秒などです。 解決策：コードに API ごとのレート制限を実装し、API ごとにリクエストのタイムスタンプを個別に追跡してください。429 応答に対して、ジッターを加えた指数バックオフを実装してください。すべての API のプランをアップグレードするのではなく、パイプラインのボトルネックになっている特定の API のアップグレードを検討してください。複数の API を呼び出す複雑なパイプラインでは、各 API の個別のレート制限を順守するキュー方式のアーキテクチャを使用してください。