news-shopping

name	news-shopping
description	Search Google News and Google Shopping using Serper APIs via x402. USE FOR: - Finding recent news articles on a topic - Current events and breaking news - Product searches and price comparisons - Shopping research and product discovery - Industry news monitoring TRIGGERS: - "news about", "latest news", "recent articles" - "current events", "breaking", "headlines" - "shopping", "buy", "price", "product search" - "compare prices", "where to buy", "deals on" Use agentcash.fetch for Serper endpoints. Both endpoints are $0.04 per call.
mcp	["agentcash"]
metadata	{"version":2}

News & Shopping Search with Serper

Access Google News and Google Shopping through x402-protected endpoints.

Setup

See rules/getting-started.md for installation and wallet setup.

Quick Reference

Task	Endpoint	Price	Description
News search	https://stableenrich.dev/api/serper/news	$0.04	Google News search
Shopping search	https://stableenrich.dev/api/serper/shopping	$0.04	Google Shopping search

News Search

Search Google News for articles:

agentcash.fetch(
  url="https://stableenrich.dev/api/serper/news",
  method="POST",
  body={
    "q": "artificial intelligence regulation"
  }
)

Parameters:

• q - Search query (required)
• num - Number of results (default: 10)
• gl - Country code (e.g., "us", "uk", "de")
• hl - Language (e.g., "en", "es", "fr")
• tbs - Time filter (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y)

Time Filters

Filter	Meaning
qdr:h	Past hour
qdr:d	Past 24 hours
qdr:w	Past week
qdr:m	Past month
qdr:y	Past year

Example - news from past week:

agentcash.fetch(
  url=".../serper/news",
  body={
    "q": "AI startups funding",
    "tbs": "qdr:w"
  }
)

Country/Language Filtering

agentcash.fetch(
  url=".../serper/news",
  body={
    "q": "technology news",
    "gl": "uk",
    "hl": "en"
  }
)

Returns:

• Article title and snippet
• Source/publication name
• Published date
• Article URL
• Thumbnail image (if available)

Shopping Search

Search Google Shopping for products:

agentcash.fetch(
  url="https://stableenrich.dev/api/serper/shopping",
  method="POST",
  body={
    "q": "wireless noise cancelling headphones"
  }
)

Parameters:

• q - Search query (required)
• num - Number of results (default: 10)
• gl - Country code for pricing/availability
• hl - Language

Returns:

• Product title
• Price and currency
• Merchant/store name
• Product URL
• Rating (if available)
• Thumbnail image

Shopping with Location

Get local pricing and availability:

agentcash.fetch(
  url=".../serper/shopping",
  body={
    "q": "MacBook Pro M3",
    "gl": "us"
  }
)

Workflows

News Monitoring

• (Optional) Check balance: agentcash.get_balance
• Search with appropriate time filter
• Review and summarize top stories

agentcash.fetch(
  url="https://stableenrich.dev/api/serper/news",
  method="POST",
  body={"q": "company name OR competitor name", "tbs": "qdr:d", "num": 20}
)

Breaking News Research

• Search with qdr:h for past hour
• Identify key sources and facts
• Note developing aspects

agentcash.fetch(
  url="https://stableenrich.dev/api/serper/news",
  method="POST",
  body={"q": "breaking news topic", "tbs": "qdr:h"}
)

Product Research

• Define search criteria (category, price range)
• Search Google Shopping
• Compare prices across merchants
• Present top options with pros/cons

agentcash.fetch(
  url="https://stableenrich.dev/api/serper/shopping",
  method="POST",
  body={"q": "ergonomic office chair under $500", "num": 20}
)

Price Comparison

• Use exact product name/model
• Compare merchant prices
• Note shipping and availability

agentcash.fetch(
  url="https://stableenrich.dev/api/serper/shopping",
  method="POST",
  body={"q": "exact product name model number"}
)

Response Data

News Article Fields

• title - Article headline
• snippet - Article excerpt
• source - Publication name
• date - Published date
• link - Article URL
• imageUrl - Thumbnail (if available)

Shopping Product Fields

• title - Product name
• price - Price with currency
• source - Merchant/store
• link - Product URL
• rating - Star rating (if available)
• reviews - Number of reviews
• imageUrl - Product image
• delivery - Shipping info (if available)

Tips

News Search

• Use quotes for exact phrases: "climate change"
• Use OR for alternatives: AI OR "artificial intelligence"
• Be specific to get relevant results
• Use time filters to avoid old news

Shopping Search

• Include brand/model for specific products
• Add "under $X" or "best" for filtered results
• Check gl parameter for accurate local pricing
• More results = better price comparison

Cost Estimation

Both endpoints are $0.04 per call.

Task	Calls	Cost
Quick news check	1	$0.04
Daily news summary	2-3	$0.08-0.12
Product research	1-2	$0.04-0.08
Full market research	3-5	$0.12-0.20