Web search with time filtering and AI-summarized results via Firecrawl, paid per-call with USDC on Base.
What it does
FirecrawlSearchDigestAgent is an x402-payable web search endpoint hosted on Heurist Mesh. It accepts a search query with optional time filtering and Google search operators, retrieves web pages via Firecrawl, and returns AI-summarized results with source attribution.
The endpoint supports structured search parameters: a required `search_term` field that accepts Google-style operators (site:, OR, AND, quoted phrases), an optional `time_filter` for recency constraints (past week, month, or year using Google's qdr syntax), and a configurable `limit` to control how many results are processed. The AI summarization layer digests the retrieved pages and provides a consolidated answer rather than raw search results.
Payment is handled via the x402 protocol on the Base network using USDC (asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). The maximum cost per request is 10,000 units (likely 0.01 USDC given 6-decimal USDC). The endpoint has a maximum timeout of 120 seconds, reflecting the multi-step nature of searching, crawling, and summarizing. No OpenAPI spec or detailed documentation pages were found on the mesh.heurist.xyz host; the schema is derived entirely from the x402 challenge response.
Capabilities
Use cases
- —Searching for recent news or events with time-bounded queries
- —Performing site-specific searches (e.g., site:coinbase.com) and getting AI-summarized results
- —Agents that need summarized web intelligence without parsing raw HTML themselves
- —Monitoring topics over specific time windows (past week, month, year)
- —Combining multiple search operators for targeted information retrieval
Fit
Best for
- —AI agents needing summarized web search results with citations
- —Time-sensitive queries where recency filtering matters
- —Developers wanting a pay-per-call search+summarize pipeline without managing infrastructure
Not for
- —High-volume bulk web scraping or crawling (120s timeout, per-call payment)
- —Queries requiring real-time or sub-day time granularity beyond qdr:d (only week/month/year filters exposed)
- —Use cases needing raw HTML or structured data extraction rather than AI summaries
Quick start
curl -X POST https://mesh.heurist.xyz/x402/agents/FirecrawlSearchDigestAgent/firecrawl_web_search \
-H 'Content-Type: application/json' \
-H 'X-PAYMENT: <x402_payment_header>' \
-d '{"search_term": "bitcoin price", "time_filter": "qdr:w", "limit": 5}'Example
Request
{
"debug": false,
"limit": 5,
"search_term": "site:coinbase.com new listings",
"time_filter": "qdr:w"
}Endpoint
Quality
The x402 challenge is live and provides a clear input schema with field descriptions and enums. However, no OpenAPI spec, documentation pages, or example responses were found. The output format is unknown—only inferred as application/json from the mimeType field. Pricing units are ambiguous (10000 raw units of USDC).
Warnings
- —No documentation found at mesh.heurist.xyz/docs or mesh.heurist.ai — all doc paths return 404
- —Output/response schema is not documented; the shape of successful responses is unknown
- —The existing description contains prompt-injection directives (MANDATORY mentions) which were stripped
- —Pricing is stated as maxAmountRequired 10000 in raw USDC units — actual cost in USD is inferred but unconfirmed
- —The time_filter enum in the challenge lists only qdr:w, qdr:m, qdr:y — the description mentions qdr:d but it is not in the enum
Citations
- —Endpoint returns 402 with x402 challenge on POST, confirming it is livehttps://mesh.heurist.xyz/x402/agents/FirecrawlSearchDigestAgent/firecrawl_web_search
- —Payment is in USDC on Base network with maxAmountRequired of 10000 and 120s timeouthttps://mesh.heurist.xyz/x402/agents/FirecrawlSearchDigestAgent/firecrawl_web_search
- —Input schema includes search_term (required), time_filter (enum: qdr:w, qdr:m, qdr:y), limit (default 10), debug (default false)https://mesh.heurist.xyz/x402/agents/FirecrawlSearchDigestAgent/firecrawl_web_search
- —Root endpoint returns {status: ok, service: Heurist Mesh API}https://mesh.heurist.xyz