# Forest Web - Sitemap Finder

> Forest Web - Sitemap Finder is a paid API for AI agents from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-20).

Discovers a website's sitemap by reading robots.txt declarations and checking conventional sitemap.xml/sitemap_index.xml locations, returning verified evidence without crawling pages

## Facts

- Endpoint: POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/sitemap/find?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forest-web-sitemap-finder-5b096a4e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j539ByHtdtylsJUBJJIS-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forest-web-sitemap-finder-5b096a4e -d '<json body>'
```

Example prompt: Before I start crawling https://www.shopify.com, can you find where their sitemap is located — check their robots.txt and the standard sitemap.xml and sitemap_index.xml paths?

## When to prefer this

Use this endpoint when you need to locate a site's sitemap before beginning a crawl, especially to avoid guessing sitemap paths or wasting requests on non-existent files. Prefer this over a full crawl when you only need the sitemap location, not its contents. It is ideal as a first step in any web indexing, SEO auditing, or content discovery pipeline where knowing the canonical sitemap URL is prerequisite to further processing.

## Known failure modes

- No sitemap found — site has neither robots.txt declarations nor standard sitemap.xml/sitemap_index.xml files
- URL unreachable or returns non-2xx response — cannot inspect robots.txt
- Malformed or non-HTTP(S) URL input returns validation error
- robots.txt declares a sitemap at an inaccessible cross-origin location
- Rate limiting or network timeout on the target domain

## How this service works

Machine-readable contract for active Forest paid capabilities. Unsigned paid calls return HTTP 402 with a PAYMENT-REQUIRED x402 challenge.

## Output

Returns verified sitemap discovery evidence including whether a sitemap was found in robots.txt declarations and/or at conventional same-origin locations (sitemap.xml, sitemap_index.xml), with the resolved sitemap URLs — without actually crawling the sitemap entries or any site pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "pattern": "^https?://",
   "maxLength": 2048,
   "minLength": 1,
   "description": "Public HTTP(S) URL to inspect, resolve, or compare."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "found": false,
   "scope": "sitemap_discovery_only_no_crawl",
   "origin": "example",
   "probes": [],
   "sitemaps": [],
   "robots_url": "example",
   "target_url": "example",
   "robots_state": "available",
   "requests_made": 1,
   "robots_status": 1,
   "rendered_javascript": false
  },
  "meta": {
   "cache": "miss",
   "provider": "robots-txt",
   "checked_at": "2026-01-01T00:00:00.000Z",
   "duration_ms": 0
  },
  "version": "1",
  "capability": "web.sitemap-find"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forest-web-sitemap-finder-5b096a4e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run](https://www.zero.xyz/host/http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/llms.txt)
