last30days-surf

Installation
SKILL.md

last30days-surf

A 30-day social + web research brief for any topic. The skill fans out across Reddit, X, YouTube, GitHub, Hacker News, Polymarket, Bluesky, TikTok, Instagram, Threads, and the open web in parallel, ranks results by real engagement (upvotes / likes / dollar-backed odds), deduplicates across platforms, and synthesizes a brief grounded in primary sources.

This skill is a port of mvanhorn/last30days-skill (MIT) at SHA 5b87cca. All real-world data retrieval and LLM-judge calls are routed through the surf MCP / surf v2 HTTP API. Credit to @mvanhorn and @j-sperling for the v3 engine architecture, planner, judge prompts, and synthesis voice contract.

Powered by surf

One API key. One balance. Reddit, HN, Polymarket, GitHub work without it (free baseline via direct HTTP); X, YouTube, Bluesky, TikTok, Instagram, Threads, Pinterest, web search, and LLM judges all route through surf when SURF_API_KEY is set. Surf takes the role of upstream's seven separate keys (xAI / ScrapeCreators / Brave / OpenRouter / Apify / X browser cookies / yt-dlp install). When direct HTTP fails for the free baseline (rate-limit, anti-bot), surf is also the resilience fallback.

Setup

  1. Get a surf API key at https://surf.cascade.fyi/app.
  2. Top up the embedded balance: load USDC into a Tempo wallet at https://wallet.tempo.xyz, then transfer that USDC to your surf wallet (address visible in the surf dashboard).
  3. Set SURF_API_KEY in your env (or in ~/.config/last30days-surf/.env / .claude/last30days-surf.env).
  4. Run /last30days-surf <topic> (or invoke the skill by name).

If you don't set SURF_API_KEY, the skill still runs but only against the free-baseline sources (Reddit, HN, Polymarket, GitHub) and without LLM-judge reranking. Brief quality drops materially. The agent should surface this state to the user.

Related skills

More from tenequm/skills

Installs
3
Repository
tenequm/skills
GitHub Stars
27
First Seen
14 days ago