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#

text

"last30days OpenAI Agents SDK"

Competitor comparison#

text

"last30days Claude Code vs Codex"

Person or company profile#

text

"last30days Peter Steinberger"

Launch reaction#

text

"last30days GPT-5 launch --deep"

Prediction-market angle#

text

"last30days bitcoin price"

Quick start#

bash

# 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#

bash

# 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:

bash

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.

bash

# 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