social-search-agent 0.1.0

Research agent using GPT-5.2 to search Reddit and Bluesky

Social Search

Research agent that searches Reddit and Bluesky using GPT-5.2 with high reasoning.

How It Works

1. Stage 1: Generates 3 search queries for your task
2. Stage 2: Runs 3 parallel LLM instances, each making tool calls to search and gather data
3. Stage 3: Compiles findings into a comprehensive report

Setup

# Clone
git clone https://github.com/yourusername/social-search.git
cd social-search

# Install
pip install -r requirements.txt

# Configure
cp example.env .env
# Edit .env with your credentials

Environment Variables

Variable	Required	Description
OPENAI_API_KEY	Yes	OpenAI API key
REDDIT_CLIENT_ID	For Reddit	Reddit app client ID
REDDIT_CLIENT_SECRET	For Reddit	Reddit app client secret
REDDIT_USERNAME	For Reddit	Reddit username
REDDIT_PASSWORD	For Reddit	Reddit password
BLUESKY_HANDLE	For Bluesky	e.g., user.bsky.social
BLUESKY_PASSWORD	For Bluesky	App password from Settings

Usage

CLI

# Reddit only (default)
python agent.py "What are Python best practices in 2024?"

# Both sources
python agent.py "AI trends" --sources reddit bluesky

# No TUI (for scripts)
python agent.py "Query" --no-tui

Interactive

python agent.py
# Prompts for task and sources

Programmatic

from agent import run_agent

report = run_agent(
    "What are Python best practices?",
    sources=["reddit"],
    show_tui=False
)
print(report)

Tools Available

Tool	Description
search_reddit	Search posts in a subreddit
get_reddit_post_with_comments	Get post + comments (2k word limit)
search_bluesky	Search Bluesky (needs auth)
get_bluesky_thread	Get thread + replies (2k word limit)

License

MIT