OEE Social Research

Conduct tiered social media research on Twitter and web sources, compiling insights into structured briefings without requiring API keys for basic access.

Audits

Pass

ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install oee-social-research

🐾 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

Tier 1 — FxTwitter API (free, fast, public tweets)
Tier 2 — Web search fallback (broader reach)
Tier 3 — Browser scraping (last resort, full fidelity)
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

# 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:

python social_research.py "TOPIC"

Output is a structured briefing on stdout.