WebLens

Official35 tools

by vasilistotskas · TypeScript

Scrape, crawl, map and extract the web. Pay per call in USDC, no account or API key.

dev.weblens/weblens (MCP)

The dev.weblens/weblens MCP server provides web scraping, crawling, mapping, and extraction capabilities. It is designed to operate on a per-call basis, with payments made in USDC. The service is described as not requiring an account or an API key.

🛠️ Key Features

Scrape the web
Crawl web content
Map and extract web data
Pay per call in USDC
No account or API key required

🚀 Use Cases

Extract information from websites via automated crawling
Build web mappings of accessible pages and resources
Retrieve structured outputs from targeted web pages

⚡ Developer Benefits

Usage billed per call (USDC)
Reduced setup friction: no account/API key needed
Supports workflows that require scraping, crawling, mapping, and extraction

⚠️ Limitations

Payment model is per call in USDC
No details provided about rate limits, tooling interfaces, or output formats

Captured live from the server via tools/list.

preview_endpoint

FREE. See what a paid WebLens endpoint costs and what it returns before paying: the live price, a one-line summary, and a recorded sample of the exact response shape. Endpoints with no paid upstream (/fetch/basic, /contents, /map) also run a real truncated LIVE preview when you pass a url; SerpAPI- and Anthropic-backed endpoints return the recorded sample only, because free live runs there would burn upstream credits. Price: free

Parameters2

endpoint	string	required	Paid endpoint path to preview, e.g. "/answer"
url	string	optional	Fetch-backed endpoints only (/fetch/basic, /contents, /map): run a real truncated preview of this URL

Raw schema

{
  "type": "object",
  "properties": {
    "endpoint": {
      "type": "string",
      "description": "Paid endpoint path to preview, e.g. \"/answer\""
    },
    "url": {
      "type": "string",
      "description": "Fetch-backed endpoints only (/fetch/basic, /contents, /map): run a real truncated preview of this URL"
    }
  },
  "required": [
    "endpoint"
  ]
}

fetch_webpage

Fetch and convert a webpage to clean markdown. Fast, no JavaScript rendering. Price: $0.002

Parameters4

url	string	required	The URL to fetch
timeout	number	optional	Request timeout in ms (default 10000)
cache	boolean	optional	Serve from cache when available (default true; cached responses cost 70% less)
cacheTtl	number	optional	Cache TTL in seconds (default 3600)

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The URL to fetch"
    },
    "timeout": {
      "type": "number",
      "minimum": 5000,
      "maximum": 30000,
      "description": "Request timeout in ms (default 10000)"
    },
    "cache": {
      "type": "boolean",
      "description": "Serve from cache when available (default true; cached responses cost 70% less)"
    },
    "cacheTtl": {
      "type": "number",
      "minimum": 60,
      "maximum": 86400,
      "description": "Cache TTL in seconds (default 3600)"
    }
  },
  "required": [
    "url"
  ]
}

fetch_webpage_pro

Fetch webpage with full JavaScript rendering. Use for SPAs and dynamic content. Price: $0.006

Parameters3

url	string	required	The URL to fetch
waitFor	string	optional	CSS selector to wait for before capturing content (e.g. ".content")
timeout	number	optional	Request timeout in ms (default 15000)

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The URL to fetch"
    },
    "waitFor": {
      "type": "string",
      "description": "CSS selector to wait for before capturing content (e.g. \".content\")"
    },
    "timeout": {
      "type": "number",
      "minimum": 5000,
      "maximum": 30000,
      "description": "Request timeout in ms (default 15000)"
    }
  },
  "required": [
    "url"
  ]
}

screenshot

Capture a screenshot of a webpage. Returns base64 PNG image. Price: $0.008

Parameters4

url	string	required	The URL to screenshot
width	number	optional	Viewport width (default 1280)
height	number	optional	Viewport height (default 720)
fullPage	boolean	optional	Capture full page scroll

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The URL to screenshot"
    },
    "width": {
      "type": "number",
      "minimum": 320,
      "maximum": 3840,
      "description": "Viewport width (default 1280)"
    },
    "height": {
      "type": "number",
      "minimum": 240,
      "maximum": 2160,
      "description": "Viewport height (default 720)"
    },
    "fullPage": {
      "type": "boolean",
      "description": "Capture full page scroll"
    }
  },
  "required": [
    "url"
  ]
}

search_web

Search the web and get real-time results with snippets. Set includeContent to also fetch the top result pages as markdown (+$0.0015/result). Price: $0.015

Parameters5

query	string	required	Search query
limit	number	optional	Number of results (default: 10)
includeContent	boolean	optional	Also fetch top result pages as markdown (+$0.0015/result)
contentResults	number	optional	How many top results to fetch content for (1-10, default: 5)
contentChars	number	optional	Per-page content character cap (default 8000)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "limit": {
      "type": "number",
      "description": "Number of results (default: 10)"
    },
    "includeContent": {
      "type": "boolean",
      "description": "Also fetch top result pages as markdown (+$0.0015/result)"
    },
    "contentResults": {
      "type": "number",
      "description": "How many top results to fetch content for (1-10, default: 5)"
    },
    "contentChars": {
      "type": "number",
      "minimum": 500,
      "maximum": 20000,
      "description": "Per-page content character cap (default 8000)"
    }
  },
  "required": [
    "query"
  ]
}

search_news

Search Google News for real-time articles with source, date, and thumbnail. Price: $0.015

Parameters2

query	string	required	News search query
limit	number	optional	Number of results (default: 10, max: 20)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "News search query"
    },
    "limit": {
      "type": "number",
      "description": "Number of results (default: 10, max: 20)"
    }
  },
  "required": [
    "query"
  ]
}

search_images

Search Google Images for direct image URLs with dimensions, thumbnails, and source pages. Price: $0.015

Parameters2

query	string	required	Image search query
limit	number	optional	Number of results (default: 10, max: 20)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Image search query"
    },
    "limit": {
      "type": "number",
      "description": "Number of results (default: 10, max: 20)"
    }
  },
  "required": [
    "query"
  ]
}

search_places

Search local businesses via Google Local: names, addresses, ratings, reviews, phone, website, coordinates. Price: $0.045

Parameters3

query	string	required	What to search for (e.g. coffee shops)
location	string	optional	Free-text location bias, e.g. "Austin, Texas"
limit	number	optional	Number of results (default: 10, max: 20)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to search for (e.g. coffee shops)"
    },
    "location": {
      "type": "string",
      "description": "Free-text location bias, e.g. \"Austin, Texas\""
    },
    "limit": {
      "type": "number",
      "description": "Number of results (default: 10, max: 20)"
    }
  },
  "required": [
    "query"
  ]
}

search_shopping

Search Google Shopping for products with prices, sellers, ratings, and links. Price: $0.015

Parameters2

query	string	required	Product search query
limit	number	optional	Number of results (default: 10, max: 20)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Product search query"
    },
    "limit": {
      "type": "number",
      "description": "Number of results (default: 10, max: 20)"
    }
  },
  "required": [
    "query"
  ]
}

search_scholar

Search Google Scholar for academic papers with snippets, publication info, and citation counts. Price: $0.015

Parameters2

query	string	required	Academic search query
limit	number	optional	Number of results (default: 10, max: 20)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Academic search query"
    },
    "limit": {
      "type": "number",
      "description": "Number of results (default: 10, max: 20)"
    }
  },
  "required": [
    "query"
  ]
}

search_autocomplete

Get Google Autocomplete suggestions for a partial query — keyword research and intent discovery. Price: $0.015

Parameters2

query	string	required	Partial query to complete
limit	number	optional	Max suggestions (default: 10, max: 20)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Partial query to complete"
    },
    "limit": {
      "type": "number",
      "description": "Max suggestions (default: 10, max: 20)"
    }
  },
  "required": [
    "query"
  ]
}

search_trends

Get Google Trends interest-over-time timeline for a query. Price: $0.015

Parameters1

query

string

required

Topic to get trend data for

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Topic to get trend data for"
    }
  },
  "required": [
    "query"
  ]
}

youtube_transcript

Get the full transcript of a YouTube video with timestamps. Accepts a video ID or any YouTube URL. Price: $0.03

Parameters2

videoId	string	required	YouTube video ID (e.g. dQw4w9WgXcQ) or full video URL
lang	string	optional	Transcript language code (default: video default)

Raw schema

{
  "type": "object",
  "properties": {
    "videoId": {
      "type": "string",
      "description": "YouTube video ID (e.g. dQw4w9WgXcQ) or full video URL"
    },
    "lang": {
      "type": "string",
      "description": "Transcript language code (default: video default)"
    }
  },
  "required": [
    "videoId"
  ]
}

get_contents

Fetch 1-20 URLs and get clean markdown per page, truncated to a character cap. Price: $0.0015/URL

Parameters3

urls	array	required	URLs to fetch (1-20)
maxChars	number	optional	Per-page content character cap (default 20000)
timeout	number	optional	Per-URL timeout in ms (default 10000)

Raw schema

{
  "type": "object",
  "properties": {
    "urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "URLs to fetch (1-20)"
    },
    "maxChars": {
      "type": "number",
      "minimum": 500,
      "maximum": 50000,
      "description": "Per-page content character cap (default 20000)"
    },
    "timeout": {
      "type": "number",
      "minimum": 5000,
      "maximum": 30000,
      "description": "Per-URL timeout in ms (default 10000)"
    }
  },
  "required": [
    "urls"
  ]
}

answer_question

Get a grounded answer with inline [n] citations: searches the web, fetches sources, and answers strictly from them. Price: $0.05

Parameters2

query	string	required	The question to answer
sources	number	optional	Web sources to search, fetch, and cite (1-5, default: 3)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The question to answer"
    },
    "sources": {
      "type": "number",
      "description": "Web sources to search, fetch, and cite (1-5, default: 3)"
    }
  },
  "required": [
    "query"
  ]
}

extract_data

Extract structured data from a webpage using a JSON schema. AI-powered extraction. Price: $0.03

Parameters3

url	string	required	The URL to extract from
schema	object	required	JSON schema defining the data structure to extract
instructions	string	optional	Natural language instructions to guide extraction

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The URL to extract from"
    },
    "schema": {
      "type": "object",
      "description": "JSON schema defining the data structure to extract"
    },
    "instructions": {
      "type": "string",
      "description": "Natural language instructions to guide extraction"
    }
  },
  "required": [
    "url",
    "schema"
  ]
}

smart_extract

Extract data using natural language. AI understands what you want. Price: $0.035

Parameters2

url	string	required	The URL to extract from
query	string	required	What data to extract (natural language)

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The URL to extract from"
    },
    "query": {
      "type": "string",
      "description": "What data to extract (natural language)"
    }
  },
  "required": [
    "url",
    "query"
  ]
}

research

One-stop research: searches web, fetches top results, and summarizes findings. Price: $0.08

Parameters2

query	string	required	Research topic or question
resultCount	number	optional	Number of sources to analyze (default: 5)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Research topic or question"
    },
    "resultCount": {
      "type": "number",
      "description": "Number of sources to analyze (default: 5)"
    }
  },
  "required": [
    "query"
  ]
}

deep_research

Multi-step cited research in one call: plans sub-questions, searches each, fetches and dedupes sources, then synthesizes an answer with inline [n] citations, key findings, and gaps. Unlike `research` ($0.08, one search + summary) this decomposes the question and cites every claim. SLOW: a standard run takes ~30-60 seconds — use a generous client timeout and do not retry on timeout. Price: $0.20 standard (3 sub-questions, 8 sources) / $0.35 deep (5 sub-questions, 12 sources)

Parameters2

query	string	required	The research question (1-500 chars)
depth	string	optional	Research tier: standard = 3 sub-questions / 8 sources ($0.20); deep = 5 / 12 ($0.35). Default: standard

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The research question (1-500 chars)"
    },
    "depth": {
      "type": "string",
      "enum": [
        "standard",
        "deep"
      ],
      "description": "Research tier: standard = 3 sub-questions / 8 sources ($0.20); deep = 5 / 12 ($0.35). Default: standard"
    }
  },
  "required": [
    "query"
  ]
}

extract_pdf

Extract text and metadata from a PDF document. Price: $0.004

Parameters1

url

string

required

URL of the PDF to extract

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL of the PDF to extract"
    }
  },
  "required": [
    "url"
  ]
}

compare_urls

Compare 2-3 webpages and get AI-generated analysis of differences. Price: $0.05

Parameters2

urls	array	required	URLs to compare (2-3)
focus	string	optional	What to focus comparison on

Raw schema

{
  "type": "object",
  "properties": {
    "urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "URLs to compare (2-3)"
    },
    "focus": {
      "type": "string",
      "description": "What to focus comparison on"
    }
  },
  "required": [
    "urls"
  ]
}

batch_fetch

Fetch multiple URLs in parallel. Efficient for bulk operations. Price: $0.0015/URL

Parameters1

urls

array

required

URLs to fetch (2-20)

Raw schema

{
  "type": "object",
  "properties": {
    "urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "URLs to fetch (2-20)"
    }
  },
  "required": [
    "urls"
  ]
}

domain_intel

Everything about a domain in one call: who registered it and when, when it expires, its DNS records, the mail and DNS providers behind them, the SaaS vendors its TXT verification tokens reveal (Google Workspace, Microsoft 365, Salesforce, Atlassian, Okta, …), SPF/DMARC posture, and risk flags like newly-registered or no-registrar-lock. Use for vendor due diligence, security triage, phishing checks and prospect research. Price: $0.005

Parameters1

domain

string

required

Domain to inspect, e.g. "stripe.com". A full URL is reduced to its hostname.

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to inspect, e.g. \"stripe.com\". A full URL is reduced to its hostname."
    }
  },
  "required": [
    "domain"
  ]
}

package_intel

Should you depend on this package? One call returns version, license, deprecation status WITH the maintainer's reason, weekly/monthly downloads, last release date, maintainer count, npm's quality/popularity/maintenance scores, and health signals (deprecated, no-recent-release, no-license, single-maintainer, no-public-repository). Supports npm and PyPI. Price: $0.003

Parameters2

name	string	required	Package name, e.g. "express" or "@scope/pkg"
registry	string	optional	Registry to look in (default npm)

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Package name, e.g. \"express\" or \"@scope/pkg\""
    },
    "registry": {
      "type": "string",
      "enum": [
        "npm",
        "pypi"
      ],
      "description": "Registry to look in (default npm)"
    }
  },
  "required": [
    "name"
  ]
}

detect_tech

What a website is built and run on, from a single fetch: framework, CMS, ecommerce platform, CDN, analytics, payments, support widgets and web server — each reported with the response header or HTML marker that proves it. Use for competitive research, sales prospecting and vendor due diligence. Price: $0.005

Parameters1

url

string

required

Site URL to fingerprint

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Site URL to fingerprint"
    }
  },
  "required": [
    "url"
  ]
}

search_discussions

What Hacker News said about a topic: matching stories with points, comment counts and links to the threads, plus aggregates — total matches, points and comments returned, most-submitted domains, and when it was first and last discussed. Price: $0.004

Parameters3

query	string	required	What to search Hacker News for
limit	number	optional	Stories to return (default 10)
sort	string	optional	Ranking (default relevance)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to search Hacker News for"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Stories to return (default 10)"
    },
    "sort": {
      "type": "string",
      "enum": [
        "relevance",
        "recent"
      ],
      "description": "Ranking (default relevance)"
    }
  },
  "required": [
    "query"
  ]
}

map_site

Discover a site's URLs without fetching page content — reads robots.txt sitemap directives, sitemap.xml and nested sitemap indexes, falling back to homepage link extraction. Price: $0.004

Parameters5

url	string	required	Site URL to map
limit	number	optional	Maximum URLs to return (1-5000, default: 1000)
include	array	optional	Only URLs whose path+query contains one of these substrings
exclude	array	optional	Skip URLs whose path+query contains one of these substrings
timeout	number	optional	Timeout in ms (default 10000)

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Site URL to map"
    },
    "limit": {
      "type": "number",
      "description": "Maximum URLs to return (1-5000, default: 1000)"
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only URLs whose path+query contains one of these substrings"
    },
    "exclude": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Skip URLs whose path+query contains one of these substrings"
    },
    "timeout": {
      "type": "number",
      "minimum": 5000,
      "maximum": 30000,
      "description": "Timeout in ms (default 10000)"
    }
  },
  "required": [
    "url"
  ]
}

crawl_site

Crawl a site and get clean markdown for every page in one synchronous call (no polling). Same-host BFS with depth and page-budget limits, robots.txt honoured by default. Price: $0.0015 per requested page (1-25) — you are billed for the requested budget, not the pages returned

Parameters8

url	string	required	Start URL — the crawl stays on this host
limit	number	optional	Page budget (1-25, default: 10) — charged per requested page
maxDepth	number	optional	Link depth from the start URL (0-3, default: 2)
include	array	optional	Only crawl URLs whose path+query contains one of these substrings
exclude	array	optional	Skip URLs whose path+query contains one of these substrings
respectRobots	boolean	optional	Honour robots.txt (default: true; disable only for sites you control)
maxChars	number	optional	Per-page content character cap (default 8000)
timeout	number	optional	Per-page timeout in ms (default 10000)

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Start URL — the crawl stays on this host"
    },
    "limit": {
      "type": "number",
      "description": "Page budget (1-25, default: 10) — charged per requested page"
    },
    "maxDepth": {
      "type": "number",
      "description": "Link depth from the start URL (0-3, default: 2)"
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only crawl URLs whose path+query contains one of these substrings"
    },
    "exclude": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Skip URLs whose path+query contains one of these substrings"
    },
    "respectRobots": {
      "type": "boolean",
      "description": "Honour robots.txt (default: true; disable only for sites you control)"
    },
    "maxChars": {
      "type": "number",
      "minimum": 500,
      "maximum": 50000,
      "description": "Per-page content character cap (default 8000)"
    },
    "timeout": {
      "type": "number",
      "minimum": 5000,
      "maximum": 30000,
      "description": "Per-page timeout in ms (default 10000)"
    }
  },
  "required": [
    "url"
  ]
}

fetch_resilient

Resilient fetch with automatic fallback: native scraper first, then headless Chromium for JS-rendered or bot-walled pages. Price: $0.008

Parameters2

url	string	required	The URL to fetch
timeout	number	optional	Timeout in ms (default 10000)

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The URL to fetch"
    },
    "timeout": {
      "type": "number",
      "minimum": 5000,
      "maximum": 30000,
      "description": "Timeout in ms (default 10000)"
    }
  },
  "required": [
    "url"
  ]
}

intel_company

Company intelligence deep dive: tech stack, funding, team, competitors, news. Price: $1.00

Parameters1

target

string

required

Company name or domain to research

Raw schema

{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "description": "Company name or domain to research"
    }
  },
  "required": [
    "target"
  ]
}

intel_market

AI-powered market research report with trends, key players, and data points. Price: $5.00

Parameters3

topic	string	required	Market or industry topic to research
depth	string	optional	Research depth (default standard)
focus	string	optional	Optional focus area

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Market or industry topic to research"
    },
    "depth": {
      "type": "string",
      "enum": [
        "quick",
        "standard",
        "comprehensive"
      ],
      "description": "Research depth (default standard)"
    },
    "focus": {
      "type": "string",
      "description": "Optional focus area"
    }
  },
  "required": [
    "topic"
  ]
}

intel_competitive

Competitive analysis: feature matrix, pricing, SWOT analysis. Price: $8.00

Parameters3

company	string	required	Company to analyze
maxCompetitors	number	optional	Max competitors to include (default: 5)
focus	string	optional	Optional focus area

Raw schema

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Company to analyze"
    },
    "maxCompetitors": {
      "type": "number",
      "description": "Max competitors to include (default: 5)"
    },
    "focus": {
      "type": "string",
      "description": "Optional focus area"
    }
  },
  "required": [
    "company"
  ]
}

intel_site_audit

Comprehensive SEO, performance, and security audit with scoring. Price: $0.75

Parameters1

url

string

required

URL to audit

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to audit"
    }
  },
  "required": [
    "url"
  ]
}

monitor_create

Create a URL change detection monitor with webhook notifications. Price: $0.01

Parameters2

url	string	required	URL to monitor for changes
webhookUrl	string	required	Webhook URL for change notifications

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to monitor for changes"
    },
    "webhookUrl": {
      "type": "string",
      "description": "Webhook URL for change notifications"
    }
  },
  "required": [
    "url",
    "webhookUrl"
  ]
}

memory_set

Store key-value data in persistent agent memory. Price: $0.001

Parameters3

key	string	required	Storage key (max 256 chars)
value	any	required	Value to store (any JSON)
ttl	number	optional	Time to live in hours (1-720, default: 168)

Raw schema

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "Storage key (max 256 chars)"
    },
    "value": {
      "description": "Value to store (any JSON)"
    },
    "ttl": {
      "type": "number",
      "description": "Time to live in hours (1-720, default: 168)"
    }
  },
  "required": [
    "key",
    "value"
  ]
}

README.md13 KBView on GitHub

WebLens

Premium web intelligence API for AI agents, with x402 micropayments. No accounts, no API keys — pay per request in USDC on Base.

🌐 Live API: https://api.weblens.dev 📖 Interactive docs: https://api.weblens.dev/docs 🤖 Agent guide: https://api.weblens.dev/llms.txt 🔎 Marketplace: listed on x402scan

Try it free, right now

No wallet, no signup — these are rate limited to 10 requests/hour per IP:

bash

curl https://api.weblens.dev/r/https://example.com     # any page as markdown
curl https://api.weblens.dev/s/cloudflare+workers      # web search

Preview before you pay (free)

An agent shouldn't have to buy a call to learn what it returns. POST /preview is free and answers that up front — the live price, a one-line summary, and a real sample of the exact response shape:

bash

curl -X POST https://api.weblens.dev/preview \
  -H "Content-Type: application/json" \
  -d '{"endpoint": "/answer"}'

jsonc

{
  "endpoint": "/answer",
  "price": "$0.05",
  "currency": "USD",
  "summary": "A direct answer with inline [n] citations to real sources.",
  "sample": { "query": "...", "answer": "...", "citations": [], "confidence": 0.92 },
  "sampleType": "recorded",
  "livePreviewAvailable": false,
  "livePreviewHint": "This endpoint calls a paid upstream provider, so free live previews are not offered — the recorded sample shows the exact response shape."
}

Live vs recorded. A real, truncated live preview runs only for endpoints whose marginal cost is a plain fetch — currently /fetch/basic, /contents and /map — and only when you pass a url. Everything else is backed by a metered upstream (SerpAPI, Anthropic); running those free would burn upstream credits, so they return the recorded sample, which still shows every field name and type. An endpoint that isn't sold returns 404.

bash

# live: the first 500 chars of the real result, for free
curl -X POST https://api.weblens.dev/preview \
  -H "Content-Type: application/json" \
  -d '{"endpoint": "/fetch/basic", "url": "https://example.com"}'

Rate limited to 10 requests/hour per IP like the rest of the free tier.

ERC-8004: receipts and feedback

ERC-8004 (Trustless Agents) keeps compact signals on-chain and the detailed documents off-chain. WebLens hosts the off-chain half — the part a service operator can run without deploying a contract. To be precise about what that is and isn't: WebLens is not registered on-chain, holds no agent id, and writes nothing to any registry.

Endpoint	What it gives you
`GET /.well-known/agent-registration.json`	The ERC-8004 registration document: name, description, image, services, `x402Support`, payment info, feedback endpoints. `registrations` is empty (no on-chain registration) and `supportedTrust` is `["feedback"]`.
`GET /receipts/{requestId}`	The receipt for a paid call — endpoint, status, outcome, price, payment method, network, pay-to. Every paid response returns `X-Receipt-Id` and `X-Receipt-Url` headers pointing here. Kept 30 days.
`POST /feedback`	Host a feedback document you author; returns `{feedbackURI, feedbackHash}` (keccak-256), the pair `giveFeedback()` expects. Required fields: `agentRegistry`, `agentId`, `clientAddress`, `createdAt`, `value`, `valueDecimals` — a missing one returns `400` naming it.
`GET /feedback/{id}`	Serves that document byte-for-byte, so its keccak-256 hash matches the `feedbackHash` you were given. This URL is the `feedbackURI`.

Two more things worth stating plainly:

A receipt's mac is a symmetric HMAC tag (the same construction as proof-of-context). Only a holder of the key can verify it — it is not a third-party-verifiable signature, and nothing here is trustless.
The buyer authors the feedback document and posts giveFeedback() themselves. WebLens only hosts the document verbatim and returns its hash; it never authors, edits, or submits feedback.

Endpoints

All paid endpoints are POST with a JSON body. Prices are per request in USDC.

Core

Endpoint	Description	Price
`/fetch/basic`	Fetch a webpage as clean markdown	$0.002
`/fetch/pro`	Fetch with full JavaScript rendering (SPAs)	$0.006
`/fetch/resilient`	Auto-fallback: native scraper → headless Chromium	$0.008
`/contents`	Bulk page text for 1–20 URLs	$0.0015/URL
`/screenshot`	Capture a webpage screenshot (PNG)	$0.008
`/batch/fetch`	Fetch 2–20 URLs in parallel	$0.0015/URL
`/map`	Discover a site's URLs (sitemaps + links, no page fetches)	$0.004
`/domain`	Registration + DNS + SaaS stack + risk signals for a domain	$0.005
`/tech`	Detect a site's framework, CMS, CDN, analytics and payments stack	$0.005
`/package`	npm/PyPI package health: deprecation, downloads, maintenance	$0.003
`/discussions`	Hacker News stories on a topic, with aggregates	$0.004
`/crawl`	Bounded whole-site crawl → markdown per page	$0.0015/page

Search

Endpoint	Description	Price
`/search`	Real-time web search (`includeContent` adds page markdown, +$0.0015/result)	$0.015
`/search/news`	Google News articles with source and date	$0.015
`/search/images`	Image results with dimensions and source pages	$0.015
`/search/places`	Local businesses: address, rating, phone, coordinates	$0.045
`/search/shopping`	Products with prices, sellers, ratings	$0.015
`/search/scholar`	Academic papers with citation counts	$0.015
`/search/autocomplete`	Query suggestions (keyword/intent research)	$0.015
`/search/trends`	Interest-over-time timeline	$0.015

Endpoint	Description	Price
`/social/youtube/transcript`	Full video transcript with timestamps	$0.03

Extraction & research

Endpoint	Description	Price
`/extract`	Structured extraction against a JSON schema	$0.03
`/extract/smart`	Natural-language extraction (no schema needed)	$0.035
`/pdf`	Extract text and metadata from a PDF	$0.004
`/answer`	Grounded answer with inline `[n]` citations	$0.05
`/research`	Search + fetch + AI summary with sources	$0.08
`/research/deep`	Multi-step cited research: sub-questions → search each → answer with inline `[n]` citations	$0.20–$0.35
`/compare`	Compare 2–3 webpages with AI analysis	$0.05

/research/deep is the only long-running endpoint: it plans sub-questions, runs a web search per sub-question, fetches and dedupes the sources, then synthesizes a cited answer — all in one synchronous call. A standard run (3 sub-questions, 8 sources, $0.20) takes roughly 30–60 seconds; deep (5 sub-questions, 12 sources, $0.35) takes longer. Set a generous HTTP timeout (120s+) and don't retry on a client timeout, or you'll pay twice.

Intelligence

Endpoint	Description	Price
`/intel/site-audit`	SEO / performance / security audit	$0.75
`/intel/company`	Company deep dive	$1.00
`/intel/market`	Market research report	$5.00
`/intel/competitive`	Competitive analysis with SWOT	$8.00

Utility

Endpoint	Description	Price
`/memory/set`	Persistent key-value storage for agents	$0.001
`/monitor/create`	URL change monitor with webhooks	$0.01 + $0.001/check
`/credits/buy`	Prepay credits (bonus 20–40% at $10/$50/$100)	$2–$1000

Free and unauthenticated: /, /health, /docs, /openapi.json, /llms.txt, /discovery, /.well-known/x402, /mcp, /r/{url}, /s/{query}, /free/fetch, /free/search, /preview, /.well-known/agent-registration.json, /receipts/{requestId}, /feedback, /feedback/{id}.

Dynamically-priced endpoints (/fetch/pro, /extract) apply a complexity multiplier — up to 3× for bot-protected domains. Cached responses on the fetch family are 70% cheaper. The exact price is always in the 402 challenge.

Use with AI agents (MCP)

Remote HTTP — nothing to install:

json

{ "mcpServers": { "weblens": { "url": "https://api.weblens.dev/mcp" } } }

Local with automatic payment:

json

{
  "mcpServers": {
    "weblens": {
      "command": "npx",
      "args": ["-y", "@weblens/mcp"],
      "env": { "PRIVATE_KEY": "0xYourPrivateKeyHere" }
    }
  }
}

See mcp-server/README.md for the full tool list and setup.

API usage

bash

# Fetch a page as markdown
curl -X POST https://api.weblens.dev/fetch/basic \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Search, with page content included
curl -X POST https://api.weblens.dev/search \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI news", "limit": 5, "includeContent": true}'

# Structured extraction
curl -X POST https://api.weblens.dev/extract \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/product",
       "schema": {"title": {"type": "string"}, "price": {"type": "number"}},
       "instructions": "Extract the product title and price"}'

# Crawl a site (pay for the page budget you request)
curl -X POST https://api.weblens.dev/crawl \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "limit": 10, "maxDepth": 2}'

# Deep research with inline citations (slow — 30-60s, so raise the client timeout)
curl --max-time 120 -X POST https://api.weblens.dev/research/deep \
  -H "Content-Type: application/json" \
  -d '{"query": "How are AI agents using micropayments in 2026?", "depth": "standard"}'

Each returns 402 Payment Required with the price until you attach payment — see below.

How payments work

WebLens implements x402 v2:

POST any paid endpoint with no payment.
Get 402 Payment Required with a PAYMENT-REQUIRED header carrying the price, network, asset, and pay-to address.
Sign a USDC transfer authorization with your wallet.
Retry the same request with a Payment-Signature header.
The payment is verified on-chain and you get your data.

Settlement runs through the PayAI facilitator on Base mainnet. Any x402 v2 client works — @x402/axios, @x402/fetch, or the bundled MCP server, which handles the whole flow for you.

Prepaid credits are an alternative to per-request payment: buy credits with /credits/buy, then send X-CREDIT-WALLET / X-CREDIT-SIGNATURE / X-CREDIT-TIMESTAMP headers. Failed requests are refunded automatically.

Development

bash

pnpm install
pnpm run dev          # local dev server on :8787
pnpm run build        # tsc --noEmit (type check)
pnpm run lint         # eslint
pnpm run test         # vitest (unit + property + workerd integration)
pnpm run deploy       # wrangler deploy (production)

Secrets are set with wrangler, never committed:

bash

wrangler secret put SERP_API_KEY        # search + all verticals + transcripts
wrangler secret put ANTHROPIC_API_KEY   # AI extraction, research, answers, intel
wrangler secret put CDP_API_KEY_ID      # optional: CDP facilitator fallback
wrangler secret put CDP_API_KEY_SECRET

Variable	Purpose
`PAY_TO_ADDRESS`	Wallet that receives payments (`wrangler.toml` var)
`NETWORK`	`base` (production) or `base-sepolia` (testnet)
`SERP_API_KEY`	SerpAPI key — search, verticals, YouTube transcripts
`ANTHROPIC_API_KEY`	Claude — extraction, research, answers, intel
`SIGNING_PRIVATE_KEY`	Optional: HMAC key for proof-of-context tags
`PAYAI_FACILITATOR_URL`	Optional: override the facilitator endpoint

Testing against testnet

bash

wrangler dev --env testnet          # Base Sepolia, fake USDC
API_URL=http://localhost:8787 PRIVATE_KEY=0x... npx tsx scripts/test-payment-testnet.ts

Get free testnet USDC from the Circle faucet on Base Sepolia.

Discovery

bash

pnpm run verify-bazaar    # check the x402 discovery extension on every route

/openapi.json doubles as the discovery document for x402scan — it carries info.x-guidance, per-operation x-payment-info, and security: [] on free operations. WebLens is listed on x402scan and indexed in the PayAI facilitator catalog.

Note on the Coinbase CDP Bazaar: it only indexes services whose payments the CDP facilitator itself settles. WebLens uses PayAI as its primary facilitator (CDP has an open Base-mainnet settlement bug, x402#1065), so it does not appear there.

Tech stack

Cloudflare Workers — edge runtime, Durable Objects, KV, Browser Rendering
Hono — web framework
x402 — HTTP-native micropayments
Zod — request validation
Vitest + fast-check — unit, property, and real-workerd integration tests

License

MIT

Install

Tools (35)

preview_endpointfetch_webpagefetch_webpage_proscreenshotsearch_websearch_newssearch_imagessearch_places

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.weblens.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "weblens": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.weblens.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

dev.weblens/weblens (MCP)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

preview_endpoint

fetch_webpage

fetch_webpage_pro

screenshot

search_web

search_news

search_images

search_places

search_shopping

search_scholar

search_autocomplete

search_trends

youtube_transcript

get_contents

answer_question

extract_data

smart_extract

research

deep_research

extract_pdf

compare_urls

batch_fetch

domain_intel

package_intel

detect_tech

search_discussions

map_site

crawl_site

fetch_resilient

intel_company

intel_market

intel_competitive

intel_site_audit

monitor_create

memory_set

WebLens

Try it free, right now

Preview before you pay (free)

ERC-8004: receipts and feedback

Endpoints

Core

Search

Social

Extraction & research

Intelligence

Utility

Use with AI agents (MCP)

API usage

How payments work

Development

Testing against testnet

Discovery

Tech stack

Links

License

Install

Remote endpoint