storyflo (Python)

Official Python client for the Storyflo audio news API. Wraps the six agent tools across all three protocols (public REST, OAuth 2.1, x402 micropayments).

pip install storyflo

Usage

from storyflo import StoryfloClient

# Public read — no auth, rate-limited per IP.
sf = StoryfloClient()

trending = sf.search_articles(vertical="tech", limit=5)
for a in trending["articles"]:
    audio = sf.get_audio_url(a["slug"])
    print(f"{a['title']} → {audio['audio_url']}")

OAuth (Claude / ChatGPT agents)

import os

sf = StoryfloClient(auth=("bearer", os.environ["STORYFLO_OAUTH_TOKEN"]))

sf.subscribe_topic(["tech", "finance"])
digest = sf.digest(window="24h", limit=5)

x402 micropayments (Coinbase AgentKit)

# `payment_header` is the base64-encoded EIP-712 authorization the
# AgentKit produces on settle. Each call costs $0.001-$0.30 USDC.
sf = StoryfloClient(auth=("x402", payment_header))
article = sf.get_article("interest-rates-q1")

API

Errors raise StoryfloError with .status and parsed .body.

License

MIT