storyflo 1.0.1

Official Python client for the Storyflo audio news API

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

Method	Tool	Auth required
search_articles(...)	search_articles	none / x402
get_article(slug)	get_article	none / x402
get_audio_url(slug)	get_audio_url	OAuth / x402
subscribe_topic(verticals)	subscribe_topic	OAuth (write scope)
list_subscriptions()	list_subscriptions	OAuth (read scope)
digest(window, limit, ...)	digest	OAuth / x402

Errors raise StoryfloError with .status and parsed .body.

License

MIT