文件内容
SKILL.md
---
name: last30days-aisa-api
description: Research the last 30 days across Reddit, X, YouTube, TikTok, Instagram,
Hacker News, Polymarket, GitHub, and grounded web search. Returns a ranked, clustered
brief with citations. Use when the task needs recent social evidence, competitor
comparisons, launch reactions, trend scans, or person/company profiles.
author: AIsa
version: 1.0.5
license: MIT
homepage: https://aisa.one
source: https://github.com/baofeng-tech/agent-skills-io/tree/main/targetSkills/last30days
user-invocable: true
primaryEnv: AISA_API_KEY
requires:
bins:
- python3
- bash
env:
- AISA_API_KEY
metadata:
aisa:
emoji: 🔎
requires:
bins:
- python3
- bash
env:
- AISA_API_KEY
optionalEnv:
- LAST30DAYS_PLANNER_MODEL
- LAST30DAYS_RERANK_MODEL
- LAST30DAYS_FUN_MODEL
- AISA_MODEL
- AISA_BASE_URL
- XIAOHONGSHU_API_BASE
- LAST30DAYS_REASONING_PROVIDER
- INCLUDE_SOURCES
- LAST30DAYS_X_BACKEND
- LAST30DAYS_YOUTUBE_TRANSCRIPTS
- LAST30DAYS_REDDIT_COMMENTS
- GH_TOKEN
- GITHUB_TOKEN
- LAST30DAYS_CONFIG_DIR
- LAST30DAYS_DEBUG
primaryEnv: AISA_API_KEY
compatibility:
- openclaw
- claude-code
- hermes
openclaw:
emoji: 🔎
requires:
bins:
- python3
- bash
env:
- AISA_API_KEY
optionalEnv:
- LAST30DAYS_PLANNER_MODEL
- LAST30DAYS_RERANK_MODEL
- LAST30DAYS_FUN_MODEL
- AISA_MODEL
- AISA_BASE_URL
- XIAOHONGSHU_API_BASE
- LAST30DAYS_REASONING_PROVIDER
- INCLUDE_SOURCES
- LAST30DAYS_X_BACKEND
- LAST30DAYS_YOUTUBE_TRANSCRIPTS
- LAST30DAYS_REDDIT_COMMENTS
- GH_TOKEN
- GITHUB_TOKEN
- LAST30DAYS_CONFIG_DIR
- LAST30DAYS_DEBUG
primaryEnv: AISA_API_KEY
---
# 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](https://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](https://agentskills.io/specification)
Requires Python 3, a POSIX shell, and `AISA_API_KEY` (get one at [aisa.one](https://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](https://aisa.one/docs/guides/models).
## API reference
last30days calls the following AIsa endpoints directly. See the [full API Reference](https://aisa.one/docs/api-reference) for the complete catalog.
- [OpenAI Chat / `createChatCompletion`](https://aisa.one/docs/api-reference/chat/createchatcompletion) — planner, reranker, fun-scorer
- [Twitter Advanced Search](https://aisa.one/docs/api-reference/twitter/get_twitter-tweet-advanced-search) — X retrieval
- [YouTube Search](https://aisa.one/docs/api-reference/search/get_youtube-search) — YouTube retrieval
- [Tavily Search](https://aisa.one/docs/api-reference/search/post_tavily-search) — grounded web
- [Polymarket Markets](https://aisa.one/docs/api-reference/prediction-market/get_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](https://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
```