spb/tendril Public
Tendril — web ingestion platform (scrape/crawl/map/search) on macOS Apple Silicon: WebKit fidelity, authenticated pages, deterministic testable extraction. A self-hosted Firecrawl alternative.
JavaScript 82.6%
TypeScript 11.8%
HTML 5.3%
1# tendril-mcp23A [Model Context Protocol](https://modelcontextprotocol.io) server that gives an4AI agent three tools backed by the Tendril API (`https://www.ten-dril.com`):56- `tendril_scrape` — fetch a page → clean Markdown + structured data + links7- `tendril_map` — discover a site's URLs (sitemaps + robots + homepage + llms.txt)8- `tendril_status` — check which fetch tiers are up910It's a single self-contained file — **no `npm install` needed**, only Node ≥ 20.1112## Install1314Save `tendril-mcp.mjs` somewhere, then point your MCP client at it.1516**Claude Desktop** — `~/Library/Application Support/Claude/claude_desktop_config.json`17(macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):1819```json20{21 "mcpServers": {22 "tendril": {23 "command": "node",24 "args": ["/absolute/path/to/tendril-mcp.mjs"],25 "env": { "TENDRIL_BASE_URL": "https://www.ten-dril.com" }26 }27 }28}29```3031**Claude Code** — from your project or user scope:3233```bash34claude mcp add tendril -- node /absolute/path/to/tendril-mcp.mjs35```3637Restart the client; you should see `tendril_scrape`, `tendril_map`, `tendril_status`.3839## Configuration4041- `TENDRIL_BASE_URL` — API base (default `https://www.ten-dril.com`; set to a local42 deployment like `http://127.0.0.1:8092` for testing).43- `TENDRIL_API_KEY` — optional Bearer token (not required today).4445Author: Simon-Pierre Boucher — contact@spboucher.ai46