StripFeed Python SDK

Official Python SDK for StripFeed - convert any URL to clean, token-efficient Markdown for AI agents, RAG pipelines, and LLM workflows.

Install

pip install stripfeed

Quick Start

from stripfeed import StripFeed

sf = StripFeed("sf_live_your_api_key")

# Full result with metadata
result = sf.fetch("https://news.ycombinator.com")
print(result["markdown"])
print(f"Tokens: {result['tokens']} (saved {result['savingsPercent']}%)")

# Just the Markdown string
md = sf.fetch_markdown("https://news.ycombinator.com")

With Options

result = sf.fetch(
    "https://example.com",
    selector="article",           # CSS selector (Pro)
    format="json",                # json, text, html (Pro)
    model="claude-sonnet-4-6",    # cost tracking
    cache=False,                  # bypass cache
    ttl=7200,                     # custom cache TTL
    max_tokens=5000,              # truncate to token budget
)

Batch (Pro plan)

result = sf.batch(
    [
        "https://example.com",
        {"url": "https://docs.anthropic.com", "selector": "article"},
    ],
    model="claude-sonnet-4-6",
)

for item in result["results"]:
    print(f"{item['url']}: {item['tokens']} tokens")

Check Usage

usage = sf.usage()
print(f"Plan: {usage['plan']}")
print(f"Used: {usage['usage']} / {usage['limit']}")
print(f"Remaining: {usage['remaining']}")

Error Handling

from stripfeed import StripFeed, StripFeedError

try:
    result = sf.fetch("https://example.com")
except StripFeedError as e:
    print(f"API error {e.status}: {e}")

Configuration

sf = StripFeed(
    "sf_live_your_api_key",
    base_url="https://custom.api/v1",  # optional
    timeout=10,                         # optional, default 30s
)

Methods

• sf.fetch(url, **options) - Fetch URL, return full result dict (markdown, tokens, metadata)
• sf.fetch_markdown(url, **options) - Fetch URL, return only Markdown string
• sf.batch(urls, model=None) - Fetch up to 10 URLs in parallel (Pro plan)
• sf.usage() - Check current monthly API usage and plan limits

Requirements

• Python 3.9+
• No external dependencies

Links

• Documentation
• Dashboard
• TypeScript SDK
• MCP Server
• GitHub