Skip to main content

Documentation Index

Fetch the complete documentation index at: https://aisa.one/docs/llms.txt

Use this file to discover all available pages before exploring further.

View on GitHub → Recent-evidence research across the social web. One AISA_API_KEY aggregates the last 30 days of signal from eight platforms plus grounded web search, then ranks and clusters the findings into a citation-backed brief — typically in ~40 seconds.

​
Install

aisa skills install last30days

​
What can agents do with it?

Trend scans

“What’s the community saying about the OpenAI Agents SDK this month?”

Competitor comparisons

“Claude Code vs Codex — who’s winning developer mindshare?”

Launch reactions

“Summarize reception of the GPT-5 launch across Reddit, X, and HN.”

Person / entity tracking

“What has Peter Steinberger been shipping and posting about lately?”

Market signals

“Bitcoin price narratives — news, prediction markets, and social sentiment.”

Structured briefs for agents

“Return JSON clusters so a downstream agent can act on the findings.”

​
Core capabilities

  • Eight sources in one call — Reddit, X/Twitter, YouTube, TikTok, Instagram, Hacker News, Polymarket, and grounded web search (plus optional GitHub with a token)
  • Ranked evidence clusters — top findings grouped by theme, each with URL, date, and engagement stats
  • Per-source breakdowns — statistical summary of which platforms are driving the signal
  • Markdown or JSON output — human-readable brief by default, structured JSON for agent pipelines
  • Deep mode — --deep flag expands the candidate pool and runs a more thorough ranking pass
  • AIsa-native planning — uses the AIsa API for query planning, candidate ranking, and semantic clustering

​
Quick start

export AISA_API_KEY="your-key"

​
Run a scan

# Trend scan
bash "${SKILL_ROOT}/scripts/run-last30days.sh" "OpenAI Agents SDK"

# Competitor comparison
bash "${SKILL_ROOT}/scripts/run-last30days.sh" "Claude Code vs Codex"

# Launch reaction (deep profile)
bash "${SKILL_ROOT}/scripts/run-last30days.sh" "GPT-5 launch --deep"
The output is a markdown brief containing the query plan, ranked candidates, semantic clusters, per-source items with dates / engagement / URLs, runtime details, and any error logs.

​
When to use it

  • Recent social evidence on trends, products, or people
  • Ranked competitor comparisons with community sentiment
  • Launch reaction summaries or shipping updates
  • Structured JSON briefs for downstream agents

​
When not to use it

  • Timeless reference questions without a recent-evidence need
  • Scenarios that require a single official source without community signal

​
Requirements

  • Python 3.12+
  • AISA_API_KEY (sign up at aisa.one — new accounts start with $2 free credit)
  • POSIX shell
  • Optional: GITHUB_TOKEN for expanded GitHub source coverage

​
Get started

  1. Sign up at aisa.one (new accounts start with $2 free credit).
  2. Generate an API key from the console.
  3. export AISA_API_KEY="your-key" and install the skill: 
    aisa skills install last30days
  4. Start a new session in your agent — the skill loads automatically.

Perplexity Search

Grounded web answers for single-query research.

Twitter Autopilot

Deeper X/Twitter-specific search, tracking, and posting.

YouTube Search

YouTube SERP for video-first topics.