last30days

Files (200)

• marketplace.json · .claude-plugin/
• plugin.json · .claude-plugin/
• .clawhubignore
• .gitignore
• settings.json · .vscode/
• tasks.json · .vscode/
• CHANGELOG.md
• CLAUDE.md
• LICENSE
• README.md
• SKILL-original.md
• SKILL.md
• SPEC.md
• TASKS.md
• openai.yaml · agents/
• app.py
• aging-portrait.jpeg · assets/
• claude-code-rap.mp3 · assets/
• dog-as-human.png · assets/
• dog-original.jpeg · assets/
• swimmom-mockup.jpeg · assets/
• auto.py
• how-search-works.md · docs/
• 2026-02-03-bird-cli-implementation.md · docs/plans/
• 2026-02-03-bird-cli-integration-design.md · docs/plans/
• 2026-02-06-feat-automated-v1-v2-test-harness-plan.md · docs/plans/
• 2026-02-06-feat-free-reddit-mcp-integration-plan.md · docs/plans/
• 2026-02-06-feat-last30days-bird-cli-release-plan.md · docs/plans/
• 2026-02-06-feat-visible-query-parsing-display-plan.md · docs/plans/
• 2026-02-06-fix-last30days-v2-formatting-reddit-citations-plan.md · docs/plans/
• 2026-02-06-fix-skill-execution-fork-mode-plan.md · docs/plans/
• 2026-02-06-test-v1-vs-v2-comparison-plan.md · docs/plans/
• 2026-02-07-feat-bundle-bird-x-search-plan.md · docs/plans/
• 2026-02-07-feat-smart-supplemental-search-plan.md · docs/plans/
• 2026-02-07-fix-x-search-query-construction-plan.md · docs/plans/
• 2026-02-07-release-v2-public-launch-plan.md · docs/plans/
• 2026-02-14-feat-codex-skill-compatibility-plan.md · docs/plans/
• 2026-02-14-feat-merge-openclaw-variant-plan.md · docs/plans/
• 2026-02-14-feat-youtube-transcript-search-plan.md · docs/plans/
• 2026-02-15-feat-clawhub-scanner-compliance-plan.md · docs/plans/
• 2026-02-15-fix-watchlist-engagement-null-crash-plan.md · docs/plans/
• 2026-02-15-fix-youtube-display-and-search-quality-plan.md · docs/plans/
• 2026-02-15-fix-youtube-timeout-and-reddit-resilience-plan.md · docs/plans/
• 2026-02-17-feat-github-release-v2.1-plan.md · docs/plans/
• 2026-02-20-feat-last30days-com-trending-topics-plan.md · docs/plans/
• 2026-02-24-feat-hacker-news-source-plan.md · docs/plans/
• 2026-02-24-fix-hn-ordering-and-emoji-plan.md · docs/plans/
• 2026-02-25-analysis-cross-source-comparison-plan.md · docs/plans/
• 2026-02-25-feat-15-test-comparison-make-cross-goat-plan.md · docs/plans/
• 2026-02-25-feat-goat-synthesis-output-comparison-plan.md · docs/plans/
• 2026-02-25-feat-polymarket-prediction-market-source-plan.md · docs/plans/
• 2026-02-25-feat-polymarket-quality-ranking-plan.md · docs/plans/
• 2026-02-25-feat-x-handle-resolution-plan.md · docs/plans/
• 2026-02-25-feat-youtube-relevance-and-cross-source-linking-plan.md · docs/plans/
• 2026-02-26-feat-polymarket-smarter-synthesis-plan.md · docs/plans/
• 2026-02-26-fix-polymarket-query-expansion-data-availability-plan.md · docs/plans/
• 2026-03-02-chore-open-pr-triage-plan.md · docs/plans/
• 2026-03-02-feat-close-pr37-codex-auth-finalization-plan.md · docs/plans/
• 2026-03-02-feat-last30days-v2.6-agent-native-invocation-plan.md · docs/plans/
• 2026-03-02-fix-websearch-sources-trailing-block-plan.md · docs/plans/
• …and 140 more

SKILL.md (first lines)

# last30days v2.9.5: Research Any Topic from the Last 30 Days

> **Permissions overview:** Reads public web/platform data and optionally saves research briefings to `~/Documents/Last30Days/`. X/Twitter search uses optional user-provided tokens (AUTH_TOKEN/CT0 env vars). Bluesky search uses optional app password (BSKY_HANDLE/BSKY_APP_PASSWORD env vars - create at bsky.app/settings/app-passwords). All credential usage and data writes are documented in the [Security & Permissions](#security--permissions) section.

Research ANY topic across Reddit, X, YouTube, and other sources. Surface what people are actually discussing, recommending, betting on, and debating right now.

## Step 0: First-Run Setup Wizard

**CRITICAL: ALWAYS execute Step 0 BEFORE Step 1, even if the user provided a topic.** If the user typed `/last30days Mercer Island`, you MUST check for FIRST_RUN and present the wizard BEFORE running research. The topic "Mercer Island" is preserved — research runs immediately after the wizard completes. Do NOT skip the wizard because a topic was provided. The wizard takes 10 seconds and only runs once ever.

To detect first run: check if `~/.config/last30days/.env` exists. If it does NOT exist, this is a first run. **Do NOT run any Bash commands or show any command output to detect this — just check the file existence silently.** If the file exists and contains `SETUP_COMPLETE=true`, skip this section and proceed to Step 1.

**When first run is detected, you MUST follow these steps IN ORDER. Do NOT skip ahead to the topic picker or research. The sequence is: (1) welcome text → (2) setup modal → (3) run setup if chosen → (4) ScrapeCreators modal → (5) topic picker. You MUST start at step 1.**

**Step 1: Display the following welcome text ONCE as a normal message (not blockquoted). Then IMMEDIATELY call AskUserQuestion — do NOT repeat any of the welcome text inside the AskUserQuestion call.**

👋 Welcome to /last30days!

I research any topic across Reddit, X, YouTube, and other sources — synthesizing what people are actually saying right now.

To get the best results, I can:
🔍 **Scan your browser** for X/Twitter cookies (free X search — reads x.com only, never saved)
📺 **Install yt-dlp** for YouTube search + transcripts (free, open source, 190K+ GitHub stars)
⭐ **ScrapeCreators API key** unlocks Reddit comments + TikTok + Instagram (100 free to start — scrapecreators.com)

We recommend all 3 before your first run — it's what makes the magic. More community sources available later. We get no kickbacks from any of these.

**Then call AskUserQuestion with ONLY this question and these options — no additional text:**

Question: "How would you like to set up?"
Options:
- "Auto setup (~30 seconds) — scans browser for X cookies (free X search) and installs yt-dlp (free YouTube transcripts)"
- "Manual setup — show me what to configure"
- "Skip for now — Reddit (threads only), HN, Polymarket, Web"

**If the user picks 1 (Auto setup):**
Run the setup subcommand:
```bash
cd {SKILL_DIR} && python3 scripts/last30days.py setup
```
Show the user the results (what cookies were found, whether yt-dlp was installed).

**Then show the ScrapeCreators push (plain text, then modal):**

⭐ One more thing — Reddit comments are some of the best content on the internet. The top-voted replies often have sharper insights than the posts themselves. ScrapeCreators unlocks these (plus TikTok + Instagram) — 100 free to start, no credit card.

**Call AskUserQuestion:**
Question: "Want to add Reddit comments to your research?"
Options:
- "Open scrapecreators.com to get my free key" — run `open https://scrapecreators.com` via Bash to open in the user's browser. Then ask them to paste the API key they get. When they paste it, write SCRAPECREATORS_API_KEY={key} to ~/.config/last30days/.env
- "I have a key — let me paste it" — accept the key, write to .env
- "Skip for now — start researching" — proceed without ScrapeCreators

**After SC key is saved (not if skipped), show the TikTok/Instagram opt-in:**

Your ScrapeCreators key also powers TikTok and Instagram search. Want those on for every research run? (Each additional source uses a ScrapeCreators call per search.)

**Call AskUserQuestion:**
Question: "Also search TikTok and Instagram?"
Options:
- "Yes, search everything — TikTok + Instagram on every run" — append `INCLUDE_SOURCES=tiktok,instagram` to ~/.config/last30days/.env. Confirm: "All set — Reddit comments, TikTok, and Instagram will run on every search."
- "Just Reddit comments for now" — don't write the flag. Confirm: "Got it — Reddit comments are on. TikTok and Instagram will kick in automatically for relevant topics like product reviews and trends. Add INCLUDE_SOURCES=tiktok,instagram to your .env anytime to force them on."

**After TikTok/Instagram opt-in (or SC skip), show the first research topic modal:**

**Call AskUserQuestion:**
Question: "What do you want to research first?"
Options:
- "Claude Code vs Codex" — tech comparison
- "Sam Altman" — person in the news
- "Warriors Basketball" — sports
- "AI Legal Prompting Techniques" — niche/professional
- "Type my own topic"

If user picks an example, run research with that topic. If they pick "Type my own", ask them what they want to research. If the user originally provided a topic with the command (e.g., `/last30days Mercer Island`), skip this modal and use their topic directly.

**END OF FIRST-RUN WIZARD. Everything above in Step 0 ONLY runs on first run. If SETUP_COMPLETE=true exists in .env, skip ALL of Step 0 — no welcome, no setup, no ScrapeCreators modal, no topic picker. Go directly to Step 1 (Parse User Intent). The topic picker is ONLY for first-time users who haven't run /last30days before.**

**If the user picks 2 (Manual setup):**
Show them this guide (present as plain text, not blockquoted):

**The magic of /last30days is Reddit comments + X posts together.** Here's how to unlock each source.

Add these to `~/.config/last30days/.env`:

**🔍 X/Twitter** (pick one — this is the most important):
- `FROM_BROWSER=auto` — easiest, free. Scans your browser cookies for x.com login.
- `AUTH_TOKEN=xxx` + `CT0=xxx` — paste your X cookies manually (x.com → F12 → Application → Cookies)
- `XAI_API_KEY=xxx` — use an xAI/Grok API key instead (api.x.ai)

**⭐ Reddit Comments + TikTok + Instagram + YouTube backup** (one key, 5 platforms):
- `SCRAPECREATORS_API_KEY=xxx` — 100 free to start at scrapecreators.com. This is the single most impactful key — Reddit comments are where the sharpest insights live.

**💡 Reddit discovery fallback** (optional):
- `OPENAI_API_KEY=xxx` — ChatGPT web search for Reddit threads. Only used if ScrapeCreators isn't configured — SC is better.

**📺 YouTube** (primary engine):
- Run `brew install yt-dlp` — free, open source. ScrapeCreators covers YouTube as backup if you skip this.

**Bonus sources** (add anytime):
- `EXA_API_KEY=xxx` — semantic web search, 1K free/month (exa.ai)
- `BSKY_HANDLE=you.bsky.social` + `BSKY_APP_PASSWORD=xxx` — Bluesky (free app password)
- `BRAVE_API_KEY=xxx` — Brave web search
- `OPENROUTER_API_KEY=xxx` — Perplexity Sonar Pro search

Always add this last line: `SETUP_COMPLETE=true`

You can paste your API keys right here and I'll write the file for you. Some people say giving LLMs your keys is risky, others live in YOLO mode. Your call.

**If the user pastes keys**, write them to `~/.config/last30days/.env` (create the file and parent dirs if needed, append without overwriting existing keys, always include `SETUP_COMPLETE=true`). Then proceed with research.

**If the user says they'll do it themselves**, tell them: "Save the file, then run `/last30days <topic>` to research anything." Then proceed with research using whatever sources are currently available.

**If the user picks Skip:**
Proceed with research immediately using the user's original topic. Note: without setup, sources are limited to Reddit (threads only, no comments), HN, and Polymarket. X/Twitter and YouTube require setup.

---

## Do I Need API Keys?

From caobach369/last30days-skill-caobach, MIT.