news-shopping

Serper によるニュース・ショッピング検索

x402 で保護されたエンドポイントを通じて、Google ニュース、Google ショッピング、Google 画像検索、Google レンズにアクセスできます。

セットアップ

インストールとウォレットの設定については、rules/getting-started.md をご覧ください。

クイックリファレンス

タスク	エンドポイント	価格	説明
ニュース検索	https://stableenrich.dev/api/serper/news	$0.04	Google ニュース検索
ショッピング検索	https://stableenrich.dev/api/serper/shopping	$0.04	Google ショッピング検索
画像検索	https://stableenrich.dev/api/serper/images	$0.04	Google 画像検索
人物画像検索	https://stableenrich.dev/api/serper/people-image-search	$0.04	人物や顔写真に特化した Google 画像検索
画像の逆検索	https://stableenrich.dev/api/serper/lens	$0.20	Google レンズによる画像の逆検索

ニュース検索

Google ニュースで記事を検索します。

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "artificial intelligence regulation"}'

パラメーター：

• q - 検索クエリ（必須）
• num - 結果数（1～100、デフォルト：10）
• gl - 国コード（例：「us」、「uk」、「de」）
• hl - 言語（例：「en」、「es」、「fr」）
• location - 場所（例：「New York, NY」）
• tbs - 期間フィルター（qdr:h、qdr:d、qdr:w、qdr:m、qdr:y）

期間フィルター

フィルター	意味
qdr:h	過去1時間
qdr:d	過去24時間
qdr:w	過去1週間
qdr:m	過去1か月
qdr:y	過去1年間

例 - 過去1週間のニュース：

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "AI startups funding", "tbs": "qdr:w"}'

国・言語による絞り込み

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "technology news", "gl": "uk", "hl": "en"}'

返される情報：

• 記事のタイトルと抜粋
• 情報源・出版物の名前
• 公開日
• 記事の URL
• サムネイル画像（利用可能な場合）

ショッピング検索

Google ショッピングで商品を検索します。

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "wireless noise cancelling headphones"}'

パラメーター：

• q - 検索クエリ（必須）
• num - 結果数（1～100、デフォルト：10）
• gl - 価格・在庫状況の国コード
• hl - 言語
• location - 場所（例：「New York, NY」）

返される情報：

• 商品名
• 価格と通貨
• 販売者・店舗名
• 商品 URL
• 評価（利用可能な場合）
• サムネイル画像

場所を指定したショッピング検索

地域の価格と在庫状況を取得します。

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "MacBook Pro M3", "gl": "us"}'

画像検索

Google 画像検索を実行します。

npx agentcash@latest fetch https://stableenrich.dev/api/serper/images -m POST -b '{"q": "aurora borealis over mountains"}'

パラメーター：

• q - 検索クエリ（必須）
• num - 結果数（1～100、デフォルト：10）
• gl - 国コード
• hl - 言語
• location - 場所（例：「New York, NY」）

返される情報：

• 画像タイトル
• 幅・高さを含む画像のフル URL
• 幅・高さを含むサムネイル URL
• ソースページ名、ドメイン、リンク

人物画像検索

人物や顔写真の検索に特化した Google 画像検索です。

npx agentcash@latest fetch https://stableenrich.dev/api/serper/people-image-search -m POST -b '{"q": "\"Jane Doe\" \"Acme\" LinkedIn headshot"}'

パラメーター： 画像検索と同じです。正確な名前と会社名・コンテキストを組み合わせたクエリを使用してください。

ヒント：

• 人物を特定しにくい場合は、まずプロフィールのスラッグ、会社名、役職を確認してください
• LinkedIn の写真が一般公開されていない場合があります。最初の検索で見つからない場合は、LinkedIn 以外の公開ソースを示す語句を使って再試行してください

画像の逆検索（レンズ）

公開画像 URL を Google レンズで逆検索します（1 回あたり $0.20）。

npx agentcash@latest fetch https://stableenrich.dev/api/serper/lens -m POST -b '{"url": "https://example.com/photo.jpg"}'

パラメーター：

• url - 逆検索する画像の公開 URL（必須）
• gl - 国コード
• hl - 言語

返される情報： タイトル、リンク、ソース、画像・サムネイル URL、価格・価格帯（利用可能な場合）、抜粋を含む organic の一致結果です。

ワークフロー

ニュースのモニタリング

• （任意）残高を確認する：npx agentcash@latest balance
• 適切な期間フィルターを使って検索する
• 主要なニュースを確認して要約する

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "company name OR competitor name", "tbs": "qdr:d", "num": 20}'

ニュース速報の調査

• 過去1時間を対象に qdr:h で検索する
• 重要な情報源と事実を特定する
• 続報が見込まれる点を記録する

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "breaking news topic", "tbs": "qdr:h"}'

商品の調査

• 検索条件（カテゴリ、価格帯）を定める
• Google ショッピングで検索する
• 販売者ごとに価格を比較する
• 長所・短所とともに上位の選択肢を提示する

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "ergonomic office chair under $500", "num": 20}'

価格の比較

• 商品名・モデル名を正確に指定する
• 販売者ごとの価格を比較する
• 配送と在庫状況を記載する

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "exact product name model number"}'

応答データ

ニュース記事のフィールド

• title - 記事の見出し
• snippet - 記事の抜粋
• source - 発行元
• date - 公開日
• link - 記事の URL
• imageUrl - サムネイル（利用可能な場合）

ショッピング商品のフィールド

• title - 商品名
• price - 通貨付きの価格
• source - 販売業者／店舗
• link - 商品の URL
• rating - 星評価（利用可能な場合）
• reviews - レビュー数
• imageUrl - 商品画像
• delivery - 配送情報（利用可能な場合）

ヒント

ニュース検索

• 完全一致するフレーズには引用符を使用します："climate change"
• 代替語句には OR を使用します：AI OR "artificial intelligence"
• 関連性の高い結果を得るには、具体的に指定します
• 古いニュースを避けるには、期間フィルターを使用します

ショッピング検索

• 特定の商品を検索するには、ブランド名／モデル名を含めます
• 絞り込んだ結果を得るには、「under $X」や「best」を追加します
• 正確な地域価格を確認するには、gl パラメーターを確認します
• 結果が多いほど、価格を比較しやすくなります

費用の見積もり

ニュース、ショッピング、画像、人物画像検索は1回あたり$0.04、Lensは$0.20です。

タスク	呼び出し回数	費用
簡単なニュース確認	1	$0.04
毎日のニュース要約	2-3	$0.08-0.12
商品調査	1-2	$0.04-0.08
詳細な市場調査	3-5	$0.12-0.20
画像または顔写真の検索	1	$0.04
画像の逆検索（Lens）	1	$0.20