stripfeed
# StripFeed
Convert any URL to clean Markdown optimized for LLM consumption. Strips ads, navigation, scripts, and noise. Returns token counts so you know exactly how much context you're using.
## When to use this skill
Use StripFeed whenever you need to read a web page, article, documentation, or any URL content. It produces much cleaner output than raw HTML fetching and tells you the token cost.
## Authentication
All requests require the `STRIPFEED_API_KEY` environment variable. Pass it as a Bearer token:
```
Authorization: Bearer $STRIPFEED_API_KEY
```
Get a free API key at https://www.stripfeed.dev (200 requests/month, no credit card).
## Fetch a single URL
```bash
curl -s "https://www.stripfeed.dev/api/v1/fetch?url=URL_HERE" \
-H "Authorization: Bearer $STRIPFEED_API_KEY"
```
This returns clean Markdown directly as the response body (Content-Type: text/markdown).
### Parameters
| Parameter | Required | Description |
| ------------ | -------- | ----------------------------------------------------------------------------------------- |
| `url` | Yes | The URL to fetch (must be http or https) |
| `format` | No | Output format: `markdown` (default), `json`, `text`, `html`. Pro only except markdown. |
| `selector` | No | CSS selector to extract specific content (e.g. `article`, `.content`, `#main`). Pro only. |
| `cache` | No | Set to `false` to bypass cache and force a fresh fetch |
| `ttl` | No | Cache TTL in seconds (default: 3600, max: 86400 for Pro) |
| `max_tokens` | No | Truncate output to fit within this token budget |
| `model` | No | AI model ID for cost tracking (e.g. `claude-sonnet-4-6`, `gpt-4o`) |
### JSON format (recommended for structured responses)
When you need metadata alongside the content, use `format=json`:
```bash
curl -s "https://www.stripfeed.dev/api/v1/fetch?url=URL_HERE&format=json" \
-H "Authorization: Bearer $STRIPFEED_API_KEY"
```
JSON response includes:
```json
{
"markdown": "# Page Title\n\nClean content...",
"url": "https://example.com",
"title": "Page Title",
"tokens": 1250,
"originalTokens": 15000,
"savingsPercent": 91.7,
"cached": false,
"fetchMs": 430,
"format": "json",
"truncated": false,
"selector": null,
"model": null
}
```
### Response headers
Every response includes these headers:
- `X-StripFeed-Tokens` - Token count of the stripped content
- `X-StripFeed-Original-Tokens` - Token count of the raw HTML (before stripping)
- `X-StripFeed-Savings-Percent` - Percentage of tokens saved
- `X-StripFeed-Cache` - `HIT` or `MISS`
- `X-StripFeed-Fetch-Ms` - Time to fetch the URL (0 if cached)
- `X-StripFeed-Format` - Output format used
## Batch fetch (Pro plan)
Fetch up to 10 URLs in a single request:
```bash
curl -s -X POST "https://www.stripfeed.dev/api/v1/batch" \
-H "Authorization: Bearer $STRIPFEED_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://example.com", "https://example.org"]}'
```
URLs can also include selectors:
```json
{
"urls": [
{ "url": "https://example.com", "selector": "article" },
{ "url": "https://example.org" }
],
"model": "claude-sonnet-4-6"
}
```
Batch response:
```json
{
"results": [
{ "url": "...", "markdown": "...", "tokens": 1250, "status": 200 },
{ "url": "...", "error": "Failed to fetch", "status": 502 }
],
"total": 2,
"success": 1,
"failed": 1
}
```
Individual URL errors don't break the batch. Check each result's `status` field.
## Error handling
| Status | Meaning |
| ------ | ---------------------------------------- |
| 401 | Missing or invalid API key |
| 403 | Feature requires Pro plan |
| 422 | Invalid URL, format, or parameter |
| 429 | Rate limit or monthly quota exceeded |
| 502 | Target URL unreachable or returned error |
| 504 | Target URL timed out (9s limit) |
## Tips
- Default format is `markdown` which returns raw text. Use `format=json` when you need token counts and metadata in the response body.
- Responses are cached for 1 hour by default. Use `cache=false` for real-time content.
- The `max_tokens` parameter is useful to fit content within your context window budget.
- Use `selector` to grab only the main content (e.g. `selector=article` or `selector=.post-content`) and skip sidebars/footers.
- Free plan: 200 requests/month, markdown format only. Pro plan ($19/mo): 100K requests, all formats, selectors, batch endpoint.
标签
skill
ai
