# 🐾 Social Research (Ravens) — What Are People Saying?

> Tiered X/Twitter research tool. Sends out the ravens, brings back intelligence.

- Skill: `modbender/social-research-ravens-what-are-people-saying` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add modbender/social-research-ravens-what-are-people-saying`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/social-research-ravens-what-are-people-saying/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/social-research-ravens-what-are-people-saying

---


# 🐾 Social Research (Ravens) — What Are People Saying?

> by Odin's Eye Enterprises — Ancient Wisdom. Modern Intelligence.

Tiered X/Twitter research tool. Sends out the ravens, brings back intelligence.

## What It Does

1. **Tier 1** — FxTwitter API (free, fast, public tweets)
2. **Tier 2** — Web search fallback (broader reach)
3. **Tier 3** — Browser scraping (last resort, full fidelity)
4. **Briefings** — Compiled research reports

## Trigger Phrases

- "what are people saying about"
- "social research on"
- "twitter research"
- "send the ravens"
- "what's the buzz on"

## Usage

```bash
# Research a topic
python social_research.py "OpenAI GPT-5 reactions"

# Research with specific tier
python social_research.py "AI agents" --tier 1

# Get cached briefing
python social_research.py --briefing "topic"
```

## Files

- `social_research.py` — main research engine
- `fxtwitter.py` — FxTwitter API client
- `.cache/` — cached results (auto-managed)
- `.briefings/` — compiled reports

## Requirements

- Python 3.10+
- No API keys for Tier 1 (FxTwitter is free)
- Web search available via agent tools for Tier 2

## For Agents

Run from the skill directory:

```bash
python social_research.py "TOPIC"
```

Output is a structured briefing on stdout.

<!-- 🐾 Huginn and Muninn fly at dawn -->