last30days 📰

30-day multi-source research brief for autonomous agents. Powered by AIsa.

One API key. Reddit, X, YouTube, TikTok, Instagram, Hacker News, Polymarket, GitHub, and grounded web search — merged into a single ranked brief.

Compatibility

Works with any agentskills.io-compatible harness, including:

• Claude Code and Claude
• OpenAI Codex
• Cursor
• Gemini CLI
• OpenCode, Goose, OpenClaw, Hermes
• and other harnesses that implement the Agent Skills specification

Requires Python 3, a POSIX shell, and AISA_API_KEY (get one at aisa.one).

Example requests

Trend scan

"last30days OpenAI Agents SDK"

Competitor comparison

"last30days Claude Code vs Codex"

Person or company profile

"last30days Peter Steinberger"

Launch reaction

"last30days GPT-5 launch --deep"

Prediction-market angle

"last30days bitcoin price"

Quick start

# 1. Export your AIsa key
export AISA_API_KEY=sk-...

# 2. First-run setup (interactive — picks planner / rerank / fun-scorer models)
bash scripts/run-last30days.sh setup

# 3. Research a topic
bash scripts/run-last30days.sh "OpenAI Agents SDK"

Common flags

# Low-latency profile (fewer candidates per source)
bash scripts/run-last30days.sh "$ARGUMENTS" --quick

# Higher-recall profile
bash scripts/run-last30days.sh "$ARGUMENTS" --deep

# Machine-readable output (full plan + candidates + clusters)
bash scripts/run-last30days.sh "$ARGUMENTS" --emit=json

# Restrict to specific sources
bash scripts/run-last30days.sh "$ARGUMENTS" --search=reddit,x,grounding

# Check provider / source availability
bash scripts/run-last30days.sh --diagnose

Inputs and outputs

Input. A topic, person, company, product, or comparison — for example: OpenAI Agents SDK, OpenClaw vs Codex, or Peter Steinberger.

Output. A markdown brief by default, or JSON with:

• query_plan — planner-generated subqueries and source weights
• ranked_candidates — reranked candidate pool with scores
• clusters — semantically grouped findings
• items_by_source — per-source item lists with dates, engagement, and URLs
• provider_runtime — which models and retrieval backends ran
• errors_by_source — any source-level failures (fail-soft)

When to use

• You need recent evidence from the last 30 days about a person, company, product, market, tool, or trend.
• You want a ranked competitor comparison, launch-reaction summary, creator or community sentiment scan, or shipping update.
• You want a structured JSON brief to feed into another agent.

When not to use

• Timeless reference questions with no recent-evidence requirement.
• Tasks where you only want one official source and do not want social or community signals.

Capabilities

• AISA-powered: planner (structured JSON query plan), reranker (relevance ordering), fun-scorer (meme or quirk signal), and hosted retrieval for X, YouTube, TikTok, Instagram, Polymarket, and grounded Tavily web search.
• Public paths (no extra credentials): Reddit and Hacker News.
• GitHub via the official API when GH_TOKEN or GITHUB_TOKEN is set — optional.
• Fail-soft: if one source errors or times out, the brief still renders with the others and notes the gap.

Model configuration

The skill makes three LLM calls per run. Each role is independently pinnable via ~/.config/last30days/.env:

LAST30DAYS_PLANNER_MODEL=qwen-flash           # fast + reliable JSON
LAST30DAYS_RERANK_MODEL=qwen-plus-2025-12-01  # quality ranking
LAST30DAYS_FUN_MODEL=qwen-flash               # cheap vibes

Or set AISA_MODEL=... for a single model across all three roles. Run last30days setup to pick interactively — the picker fetches the live catalog from aisa.one/docs/guides/models.

API reference

last30days calls the following AIsa endpoints directly. See the full API Reference for the complete catalog.

• OpenAI Chat / createChatCompletion — planner, reranker, fun-scorer
• Twitter Advanced Search — X retrieval
• YouTube Search — YouTube retrieval
• Tavily Search — grounded web
• Polymarket Markets — prediction-market retrieval

Reddit and Hacker News use their respective public APIs directly (no AISA proxy required).

Requirements

• Python 3.12+
• AISA_API_KEY — required. Get one at aisa.one.
• GH_TOKEN / GITHUB_TOKEN — optional, enables the GitHub source.

# Pin an interpreter ≥ 3.12
for py in /usr/local/python3.12/bin/python3.12 python3.14 python3.13 python3.12 python3; do
  command -v "$py" >/dev/null 2>&1 || continue
  "$py" -c 'import sys; raise SystemExit(0 if sys.version_info >= (3, 12) else 1)' || continue
  LAST30DAYS_PYTHON="$py"
  break
done