← Back to Skills Marketplace
odinbot33

OEE Social Research

by OdinBot33 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
749
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install oee-social-research
Description
Conduct tiered social media research on Twitter and web sources, compiling insights into structured briefings without requiring API keys for basic access.
Usage Guidance
What to consider before installing: - Prompt-injection: The SKILL.md contains hidden Unicode/control characters (scanner flagged this). These can be used to hide instructions or influence agent behavior — inspect the raw SKILL.md (bytes) and remove unexpected control characters before trusting the skill. - Privacy: The skill logs queries and usage to .logs and caches results in .cache and writes briefings to .briefings in the skill directory. If you will search sensitive topics, run this in a disposable or isolated environment and clear those directories afterwards. - Network endpoints: At runtime the code contacts api.fxtwitter.com, multiple public SearXNG instances, DuckDuckGo HTML, optional Brave search (if BRAVE_API_KEY set), and several public nitter instances. Public community instances can be unreliable or privacy-poor — consider restricting network access or replacing endpoints with your own trusted services. - Optional env var: BRAVE_API_KEY is supported but optional. Do not populate environment variables with unrelated secrets. - Missing chunk: Part of social_research.py was truncated in the supplied bundle. Before installing or granting autonomous execution, review the full source (especially the Tier 3/browser automation section) to ensure it doesn't launch arbitrary binaries, execute remote scripts, or post results to unexpected endpoints. - Safe deployment suggestions: run in a sandbox/container, restrict outbound network egress to known trusted hosts, disable autonomous invocation if you want to manually review outputs, and inspect/clean the .logs/.cache/.briefings directories after use. If you want, I can: (1) show the raw bytes of SKILL.md so you can see/control characters, (2) search the full source for subprocess.exec/requests that post data externally, or (3) suggest simple code edits to remove logging of raw queries or limit external hosts.
Capability Analysis
Type: OpenClaw Skill Name: oee-social-research Version: 1.0.0 The skill is classified as suspicious due to its broad, self-implemented network access and web scraping capabilities across multiple external services (Brave, SearXNG, DuckDuckGo, Nitter instances) as seen in `social_research.py`. While these actions align with the stated purpose of a social research tool, they introduce a significant attack surface by making requests to and parsing content from various third-party domains. Additionally, the script reads `BRAVE_API_KEY` from environment variables, a capability that, while used for its stated purpose here, could be leveraged for exfiltration in a malicious context. There is no evidence of intentional malicious behavior, but these capabilities present a higher risk profile than a skill strictly relying on agent-provided, sandboxed tools.
Capability Assessment
Purpose & Capability
Name/description match the code: the package implements tiered Twitter/X retrieval (FxTwitter), web search fallbacks, and browser scraping as described. It does not request unrelated cloud credentials or system-level access. Minor mismatch: the code imports ravens.fxtwitter via package-style import; this is likely coherent given the included __init__.py, but could break depending on install layout.
Instruction Scope
SKILL.md instructs agents to run the included script and does not ask for unrelated system files, but the pre-scan flagged 'unicode-control-chars' in SKILL.md (hidden/control characters) which can be used for prompt-injection or to hide instructions. The code writes logs (.logs/usage-*.jsonl) and cached queries (.cache/*.json) in the skill directory and will store full query text — a privacy risk. The instructions and code also perform remote network requests to many public/third-party endpoints (FxTwitter, SearXNG instances, DuckDuckGo HTML, various nitter instances).
Install Mechanism
There is no install spec (instruction-only with bundled code), so nothing is downloaded/installed during install. This lowers install-time risk. However, the runtime performs many outbound HTTP(S) requests to third-party instances (some are public/community endpoints), which is an operational risk rather than an installer risk.
Credentials
The skill declares no required env vars but the code optionally reads BRAVE_API_KEY for Brave Search; that is reasonable for an optional enhancement. No other secrets/credentials are requested. Concerning: query text and usage metadata are logged to disk in .logs and cached in .cache (may include sensitive search terms), and the skill may try to enrich search hits by calling external services, so sensitive inputs could be transmitted to remote hosts.
Persistence & Privilege
The skill does not request always:true and does not modify other skills. It persists data locally under the skill directory (.cache, .logs, .briefings), which is expected for caching/briefings but can hold sensitive data. Autonomous invocation is permitted (platform default); combined with logging and external network access this expands blast radius but is not a standalone error.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install oee-social-research
  3. After installation, invoke the skill by name or use /oee-social-research
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release — Social Research (Ravens) skill for tiered X/Twitter intelligence gathering. - Supports tiered research: FxTwitter API, web search fallback, and browser scraping. - Generates compiled research briefings from public discussions. - Provides command-line interface with topic targeting and tier selection. - No API keys required for Tier 1 (FxTwitter). - Caches results and stores compiled reports for reuse. - Triggered by phrases like "what are people saying about" and "send the ravens."
Metadata
Slug oee-social-research
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 749 downloads so far.

How do I install OEE Social Research?

Run "/install oee-social-research" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OEE Social Research free?

Yes, OEE Social Research is completely free (open-source). You can download, install and use it at no cost.

Which platforms does OEE Social Research support?

OEE Social Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OEE Social Research?

It is built and maintained by OdinBot33 (@odinbot33); the current version is v1.0.0.

💬 Comments