# Web Reader & Search (Tanod)

> Web search for agents: page to Markdown, screenshots, news search, metadata, sitemaps and RDAP. A focused part of Tanod (https://tanod.dev/llms.txt covers every family), over HTTP and MCP.
>
> Pay per call in USDC on Base or Polygon or Solana or BNB Chain or Arbitrum with x402, or on Tempo with MPP; no account or API key. Free tier: a small daily per-IP
> pool per family; over HTTP add the header `X-Tanod-Free: 1` to an unpaid call (without it every unpaid call gets the 402); over MCP
> the free tier is automatic.
> Every result is automated and heuristic, not an audit: findings can be false positives, and a clean result is not proof that code or a package is free of risk.
> Tanod is operated by an autonomous AI agent on behalf of its owner. Scans run automatically; no person reviews individual results.

## API

- [OpenAPI spec](https://web.tanod.dev/openapi.json): machine-readable description of this family's 40 routes.
- [x402 resources](https://web.tanod.dev/.well-known/x402)
- MCP: `https://tanod.dev/mcp/web` (server `tanod-web`); also at `https://web.tanod.dev/mcp` on this host

## Routes

- `POST https://web.tanod.dev/v1/news/crypto` (get_latest_crypto_news_headlines): Use when an agent must decide which crypto stories to react to: top headlines ranked by outlet coverage, new ones only.
- `POST https://web.tanod.dev/v1/markets/predictions` (search_prediction_markets_polymarket): Use when an agent needs to see what odds traders put on an event: Polymarket probabilities, volume and liquidity for a topic.
- `POST https://web.tanod.dev/v1/trends/attention` (get_topic_trends): Use when an agent must tell if interest in a topic is rising or fading: Wikipedia, Hacker News and news over time.
- `POST https://web.tanod.dev/v1/render` (scrape_web_page): Use when an agent must scrape a web page or fetch a URL as clean Markdown instead of raw HTML.
- `POST https://web.tanod.dev/v1/domain/inspect` (get_dns_records): Use when an agent must check a domain's DNS records, email authentication or TLS setup.
- `POST https://web.tanod.dev/v1/pdf` (pdf_to_text): Use when an agent needs PDF to text: the text of a public PDF given only its URL.
- `POST https://web.tanod.dev/v1/meta` (get_web_page_metadata): Use when an agent needs a page's title, description, Open Graph tags or feeds without fetching the whole page.
- `POST https://web.tanod.dev/v1/rdap` (whois_lookup): Use when an agent needs who registered a domain, IP or AS number, with dates, status and abuse contact.
- `POST https://web.tanod.dev/v1/email/verify` (verify_email_address): Use when an agent must decide whether an email address looks deliverable before sending or storing it.
- `POST https://web.tanod.dev/v1/ip` (lookup_ip_address): Use when an agent has an IP address and needs its network owner, ASN, registration country and reverse DNS.
- `POST https://web.tanod.dev/v1/search` (web_search): Use when an agent needs a web search: search engine results (title, URL, snippet) for a query.
- `POST https://web.tanod.dev/v1/url` (parse_url): Use when an agent must split a URL into its parts, registrable domain and IDNA form without fetching it.
- `POST https://web.tanod.dev/v1/headers` (check_security_headers): Use when an agent must check which security headers a site's response sets and what is missing.
- `POST https://web.tanod.dev/v1/robots` (check_robots_txt): Use when an agent must know whether a crawler may fetch a URL under the site's robots.txt before scraping it.
- `POST https://web.tanod.dev/v1/sitemap` (parse_sitemap_urls): Use when an agent needs the list of URLs a site publishes in its XML or text sitemap.
- `POST https://web.tanod.dev/v1/links` (list_page_links_check_broken): Use when an agent needs every link on a page sorted into internal, external, anchor, mailto and tel.
- `POST https://web.tanod.dev/v1/html-to-text` (convert_html_to_text): Use when an agent holds an HTML document and needs it as plain text or Markdown.
- `POST https://web.tanod.dev/v1/feeds/parse` (parse_rss_feed): Use when an agent must read an RSS, Atom or podcast feed URL as clean JSON (feed data, items, dates, enclosures).
- `POST https://web.tanod.dev/v1/podcast/search` (search_podcasts): Use when an agent must find a podcast's RSS feed URL and latest episodes from a show name or Apple link.
- `POST https://web.tanod.dev/v1/pdf/html-to-pdf` (url_to_pdf): Use when a URL or web page must be converted to a PDF document. Add output=url for a 24 h link.
- `POST https://web.tanod.dev/v1/check/url` (check_phishing_url): Use when an agent is about to open or share a URL and wants it matched against phishing and scam domain lists.
- `POST https://web.tanod.dev/v1/web/screenshot` (take_website_screenshot): Use when an agent must screenshot a URL: an image of how a web page renders. Add output=url for a 24 h link.
- `POST https://web.tanod.dev/v1/papers/digest` (digest_academic_papers_on_a_topic): Use when an agent needs a quick read of a research topic: top papers by citations and recency, each abstract summarized.
- `POST https://web.tanod.dev/v1/company/profile` (company_profile_from_domain): Use when an agent must research a company from its domain: site metadata, social links, DNS tools and registration.
- `POST https://web.tanod.dev/v1/company/jobs` (company_open_jobs): Use when an agent needs the jobs a company has open now, by department and location, from its ATS job board.
- `POST https://web.tanod.dev/v1/domain/availability` (check_domain_availability): Use when an agent must check whether domain names are free to register before suggesting or buying them.
- `POST https://web.tanod.dev/v1/company/lei` (company_lei_lookup): Use when an agent must resolve a LEI to a legal entity: name, status, address, parents (GLEIF).
- `POST https://web.tanod.dev/v1/company/lei-search` (find_company_lei): Use when an agent must find the LEI of a company by name, optionally in one country.
- `POST https://web.tanod.dev/v1/vehicle/vin-decode` (vehicle_vin_decode): Use when an agent must decode a VIN into make, model, year, trim, engine and plant (NHTSA, US data).
- `POST https://web.tanod.dev/v1/vehicle/recalls` (vehicle_recalls): Use when an agent must list the NHTSA safety recalls of a US-market vehicle by make, model, year or VIN.
- `POST https://web.tanod.dev/v1/search/contents` (search_web_with_page_contents): Use when an agent must search and read results: web search plus page Markdown in one call (static fetch).
- `POST https://web.tanod.dev/v1/render/batch` (fetch_multiple_urls_to_markdown): Use when an agent needs the Markdown of up to 5 public web pages in one call instead of one call per URL.
- `POST https://web.tanod.dev/v1/contents` (get_contents_of_urls): Use when an agent needs the text of up to 10 URLs in the common contents API shape, as a drop-in base URL.
- `POST https://web.tanod.dev/v1/papers/search` (papers_search): Use when an agent must find academic papers on a topic: title, authors, year, DOI, abstract, open-access link.
- `POST https://web.tanod.dev/v1/news/search` (search_news): Use when an agent needs recent news articles on a topic: headlines, links, source and time, newest first.
- `POST https://web.tanod.dev/v1/social/search` (search_social_posts): Use when an agent needs recent public posts about a topic from Bluesky and Hacker News, not X/Twitter.
- `POST https://web.tanod.dev/v1/markets/event-contracts` (search_prediction_market_odds): Use when an agent needs US event-contract odds: implied probability, bid/ask, volume, close time by topic.
- `POST https://web.tanod.dev/v1/web/status-page` (check_api_status_page): Use when an agent must know whether an API or SaaS is up: its status page's overall state, degraded parts, incidents.
- `POST https://web.tanod.dev/v1/text/source-check` (check_text_plagiarism_copied_web_sources): Use when an agent must see whether a text's sentences already appear on the web word for word, before publishing it.
- `POST https://web.tanod.dev/v1/web/evidence` (capture_web_evidence): Use when an agent or its owner must prove what a web page showed: screenshot, PDF, text, hashes, signed manifest.