🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί OEE Social Research
πŸ¦€ ClawHub

OEE Social Research

by @odinbot33

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

Versionv1.0.0
Downloads1,468
#api#research#social-media#legal
TERMINAL
clawhub install oee-social-research

πŸ“– About This Skill

🐾 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

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

    πŸ’‘ Examples

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