| name | obul-firecrawl-search |
| description | USE THIS SKILL WHEN: the user wants to search the web and get scraped content from results. Provides web search with auto-scraped markdown via Firecrawl through the Obul proxy. |
| homepage | https://www.firecrawl.dev |
| metadata | {"obul-skill":{"emoji":"🔍"}} |
| registries | {} |
Firecrawl Search
Firecrawl's web search endpoint — search the web and get clean, scraped content from the results in a single call.
Through the Obul proxy, each request is paid individually — no Firecrawl account or API key required.
Authentication
All requests use the obulx CLI, which handles proxy routing and authentication automatically.
Install and log in (one-time setup):
npm install -g @obul.ai/obulx
obulx login
Base URL: https://firecrawl.x402endpoints.com
Common Operations
Search the Web
Search the web and get clean, scraped content from the results. Useful for finding and reading pages on a topic without
knowing specific URLs.
Pricing: $0.002
obulx -X POST -H "Content-Type: application/json" \
-d '{"query": "firecrawl web scraping API", "limit": 5}' \
"https://firecrawl.x402endpoints.com/v1/search"
Response: Array of search results, each containing the page URL, title, and scraped content in clean markdown
format.
Search with Scrape Options
Search and control how result pages are scraped — request specific formats, include only certain tags, or exclude
elements like navigation.
Pricing: $0.002
obulx -X POST -H "Content-Type: application/json" \
-d '{"query": "x402 payment protocol", "limit": 3, "scrapeOptions": {"formats": ["markdown", "links"]}}' \
"https://firecrawl.x402endpoints.com/v1/search"
Response: Search results with content in the requested formats. The links format returns all URLs found on each
result page.
Search with Time Filter
Restrict search results to a specific time period using the tbs parameter.
Pricing: $0.002
obulx -X POST -H "Content-Type: application/json" \
-d '{"query": "x402 ecosystem news", "tbs": "qdr:w", "lang": "en"}' \
"https://firecrawl.x402endpoints.com/v1/search"
Response: Search results filtered to the specified time period. tbs values: qdr:h (past hour), qdr:d (past
day), qdr:w (past week), qdr:m (past month).
Endpoint Pricing Reference
| Endpoint | Price | Purpose |
|---|
POST /v1/search | $0.002 | Web search with scraped content |
When to Use
- Web research — Find and read pages on a topic without knowing specific URLs.
- Current events — Search for recent news or developments with time filters.
- Competitive analysis — Search for information about companies, products, or technologies.
- Content discovery — Find relevant pages to scrape or analyze further.
Best Practices
- Use
limit to control cost — Default is 5 results. Increase for broader research, decrease for quick lookups.
- Add
scrapeOptions — Control output formats (markdown, html, links) to get exactly what you need.
- Use time filters — Add
tbs for time-sensitive queries to get fresh results.
- Prefer this over raw search + scrape — Firecrawl search combines both in one call, saving time and cost.
Error Handling
| Error | Cause | Solution |
|---|
402 Payment Required | Payment not processed or insufficient | Verify your account has sufficient balance at my.obul.ai. Run obulx login if not authenticated. |
400 Bad Request | Missing or invalid request body | Ensure the query field is present and non-empty. |
429 Too Many Requests | Rate limit exceeded | Add a short delay between requests. |
500 Internal Server Error | Upstream Firecrawl service issue | Wait a few seconds and retry. |
