`README.md`

74 lines
# /last30

**An agent skill that tells you what people actually said about a topic in the last
30 days — ranked by real engagement, not editors.**

Runs a zero-dependency Python engine over free, no-key public APIs (Hacker News,
arXiv, GitHub, Polymarket), layers in social platforms (Reddit, X, YouTube, TikTok,
Instagram) via the host agent's own web search, scores everything by
**engagement × recency**, and
synthesizes one grounded, cited brief.

Inspired by [mvanhorn/last30days-skill](https://github.com/mvanhorn/last30days-skill)
(MIT), surfaced by [@Saboo_Shubham_](https://x.com/saboo_shubham_) — whose pro tip was
literally *"use this open-source skill … to make it your own."* This is that: an
independent, **no-key, $0-local** reimplementation for a host that already has web
search (e.g. Claude Code + Exa MCP).

## What's different from the original

| | Original `/last30days` | This `/last30` |
|---|---|---|
| Social platforms | ScrapeCreators paid key + vendored X client | Host's existing web search (Exa/WebSearch) |
| Dependencies | Python + Node + yt-dlp + CLIs | **Python stdlib only** |
| Default cost | PAYG after free tier | **$0** (free APIs + already-present web search) |
| Engine sources | many | HN · arXiv · GitHub · Polymarket (all no-key) |

## Layout

```
last30-skill/
├── README.md
├── LICENSE                     # MIT
└── skills/
    └── last30/                 # the installable skill
        ├── SKILL.md            # runtime contract (intent → engine → synth)
        ├── scripts/
        │   └── last30.py       # zero-dependency engine + `doctor`
        └── references/
            └── sources.md      # source matrix, scoring, extending
```

## Quick start

```bash
# health-check every free source
python3 skills/last30/scripts/last30.py doctor

# research a topic (markdown brief)
python3 skills/last30/scripts/last30.py "nvidia earnings reaction" --emit markdown

# tighter window, more items, JSON for downstream synthesis
python3 skills/last30/scripts/last30.py "AI video tools" --days 14 --limit 8 --emit json
```

## Install as a skill

Symlink (or copy) `skills/last30/` into your agent's skills directory:

```bash
ln -s "$(pwd)/skills/last30" ~/.claude/skills/last30
```

Then invoke `/last30 <topic>` in your agent.

## Requirements

- Python 3.9+ (standard library only — no `pip install`)
- A host web-search tool for the social-platform layer (optional but recommended):
  an Exa MCP connection, or the agent's built-in WebSearch.

## License

MIT — see [LICENSE](LICENSE). Credit to mvanhorn for the original idea.