competitor_pricing_scrape
Scrape and parse a competitor pricing page from a URL or domain. Fetches via proxy-aware timedFetch (tries /pricing, /plans, homepage fallback), then extracts: plan names, prices, billing cadence (monthly/annual/usage-based/one-time), key features, free tier presence, enterprise tier, estimated price range. Returns structured pricing tiers. If unfetchable or no pricing found (anti-bot, SPA, auth wall): returns a clear degraded result with warnings and signals — never fake success. ICP: founders, product managers, pricing strategists, competitive intel teams. Proxy-aware (AICI_RESEARCH_PROXY_URL). Cache TTL 6h.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Competitor URL or domain (e.g. 'https://notion.so/pricing', 'notion.so', 'https://www.example.com'). For best results, provide the direct pricing page URL. | |
| async | No | If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tiers | Yes | ||
| domain | Yes | ||
| status | Yes | ||
| warnings | Yes | ||
| url_fetched | Yes | ||
| has_free_tier | Yes | ||
| pricing_found | Yes | ||
| quality_score | Yes | ||
| raw_price_signals | Yes | ||
| has_enterprise_tier | Yes | ||
| plan_names_detected | Yes | ||
| billing_model_signals | Yes | ||
| estimated_price_range | Yes |