Competitor Intelligence

"Monitor @OpenAI - alert me on new tweets, news mentions, and paper releases"

Investment Research

"Full analysis on NVDA: price trends, insider trades, analyst estimates, 
SEC filings, and Twitter sentiment"

Startup Validation

"Research the market for AI writing tools - find competitors, 
Twitter discussions, and academic papers on the topic"

Crypto Whale Alerts

"Track large BTC movements and correlate with Twitter activity"

AIsa vs bird

Feature	AIsa ⚡	bird 🐦
Auth method	API Key (simple)	Browser cookies (complex)
Read Twitter	✅	✅
Post/Like/Retweet	✅ (via login)	✅
Web Search	✅	❌
Scholar Search	✅	❌
News/Financial	✅	❌
LLM Routing	✅	❌
Server-friendly	✅	❌
Cost	Pay-per-use	Free

Use AIsa when: Server environment, need search/scholar APIs, prefer simple API key setup. Use bird when: Local machine with browser, need free access, complex Twitter interactions.

Quick Start

export AISA_API_KEY="your-key"

Core Capabilities

Twitter/X Data (Read)

# Get user info
curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Advanced tweet search
curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Latest" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get trending topics (worldwide)
curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \
  -H "Authorization: Bearer $AISA_API_KEY"

Twitter/X Post (Write)

⚠️ Warning: Posting requires account login. Use responsibly to avoid rate limits or account suspension.

# Step 1: Login first (async, check status after)
curl -X POST "https://api.aisa.one/apis/v1/twitter/user_login_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_name":"myaccount","email":"me@example.com","password":"xxx","proxy":"http://user:pass@ip:port"}'

# Step 2: Send tweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/send_tweet_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_name":"myaccount","text":"Hello from OpenClaw!"}'

# Like / Retweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/like_tweet_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_name":"myaccount","tweet_id":"1234567890"}'

Search (Web + Academic)

# Web search
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/web?query=AI+frameworks&max_num_results=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Academic/scholar search
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=transformer+models&max_num_results=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Smart search (web + academic combined)
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/smart?query=machine+learning&max_num_results=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

Financial News

# Company news by ticker
curl "https://api.aisa.one/apis/v1/financial/news?ticker=AAPL&limit=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

LLM Routing (OpenAI Compatible)

curl -X POST "https://api.aisa.one/v1/chat/completions" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4", "messages": [{"role": "user", "content": "Hello"}]}'

Supported models: GPT-4, Claude-3, Gemini, Qwen, Deepseek, Grok, and more.

Python Client

# Twitter Read
python3 {baseDir}/scripts/aisa_client.py twitter user-info --username elonmusk
python3 {baseDir}/scripts/aisa_client.py twitter search --query "AI agents"
python3 {baseDir}/scripts/aisa_client.py twitter trends --woeid 1

# Twitter Write (requires login first)
python3 {baseDir}/scripts/aisa_client.py twitter login --username myaccount --email me@example.com --password xxx --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/aisa_client.py twitter post --username myaccount --text "Hello!"
python3 {baseDir}/scripts/aisa_client.py twitter like --username myaccount --tweet-id 1234567890

# Search
python3 {baseDir}/scripts/aisa_client.py search web --query "latest AI news"
python3 {baseDir}/scripts/aisa_client.py search scholar --query "LLM research"
python3 {baseDir}/scripts/aisa_client.py search smart --query "machine learning"

# News
python3 {baseDir}/scripts/aisa_client.py news --ticker AAPL

# LLM
python3 {baseDir}/scripts/aisa_client.py llm complete --model gpt-4 --prompt "Explain quantum computing"

Pricing

API	Cost
Twitter query	~$0.0004
Twitter post/like	~$0.001
Web search	~$0.001
Scholar search	~$0.002
News	~$0.001
LLM	Token-based

Every response includes usage.cost and usage.credits_remaining.

Error Handling

Errors return JSON with error field:

{
  "error": "Invalid API key",
  "code": 401
}

Common error codes:

401 - Invalid or missing API key
402 - Insufficient credits
429 - Rate limit exceeded
500 - Server error

Get Started

Sign up at aisa.one
Get your API key
Add credits (pay-as-you-go)
Set environment variable: export AISA_API_KEY="your-key"

Full API Reference

See API Reference for complete endpoint documentation.

openclaw-starter-kit

OpenClaw Starter Kit 🦞

🔥 What Can You Do?

Morning Briefing (Scheduled)