← Back to Skills Marketplace
645
Downloads
2
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install social-data
Description
Fetch real-time social media data from X (Twitter) and Reddit by keyword, username, date range, and filters with engagement metrics via Macrocosmos SN13 API.
Usage Guidance
Do not install or supply secrets until the metadata mismatch is resolved. Specific actions to consider: 1) Ask the skill publisher to update registry metadata to declare MC_API as a required secret and to provide the GitHub/PyPI homepage/source links they cite in SKILL.md. 2) Verify the upstream repository (https://github.com/macrocosm-os/macrocosmos-mcp) and PyPI package to ensure the package and endpoint are legitimate. 3) If you must test, create a low-privilege or limited-use MC_API key and avoid using high-privilege credentials. 4) Confirm the domain (constellation.api.cloud.macrocosmos.ai) is the intended recipient of the key and review the provider's privacy/data retention policy. 5) Request an explicit install spec if you expect the Python SDK to be used (so installations are visible/auditable). The current inconsistencies could be innocent (metadata omission) but should be fixed before granting access to secrets.
Capability Analysis
Type: OpenClaw Skill
Name: social-data
Version: 1.0.4
The skill bundle is benign. The `SKILL.md` provides clear instructions and examples for interacting with the Macrocosmos SN13 API to fetch social media data. All API calls are directed to `constellation.api.cloud.macrocosmos.ai`, and the required `MC_API` key is used for legitimate authentication. There is no evidence of prompt injection against the agent, unauthorized data exfiltration, malicious execution, persistence mechanisms, or obfuscation. The instructions for the LLM agent are focused on best practices for using the API effectively.
Capability Assessment
Purpose & Capability
The SKILL.md describes exactly the claimed capability (fetching X/Reddit data via Macrocosmos SN13). The API endpoints, request/response format, and examples align with the stated purpose. However, registry metadata (source/homepage/required env vars) does not match the SKILL.md: the registry lists no required env var or homepage/source, while SKILL.md requires an MC_API key and points to GitHub/PyPI. That metadata mismatch is an incoherence to resolve before trusting the skill.
Instruction Scope
The instructions are narrowly scoped to making POST requests to the Macrocosmos SN13 endpoint (and using a Python SDK) and do not instruct the agent to read arbitrary local files or exfiltrate data to unrelated endpoints. Example calls clearly show the API key being used only for requests to constellation.api.cloud.macrocosmos.ai.
Install Mechanism
This is an instruction-only skill with no install spec (lowest install risk). However, SKILL.md references a Python SDK ('macrocosmos' on PyPI) but provides no install guidance. That omission is not necessarily malicious but is an operational inconsistency: an agent may try to install the SDK or fail at runtime if the client is expected but not present.
Credentials
SKILL.md requires a secret MC_API environment variable (used as a Bearer token). That credential is proportionate to the skill's function, but the skill registry metadata did not declare any required env vars or primary credential. The missing declaration is a material inconsistency: users may not be warned that the skill needs a secret, and automated permission controls may not be applied. Verify the MC_API scope/permissions before providing it and confirm the registry metadata is corrected.
Persistence & Privilege
The skill does not request always:true, does not ask to modify agent/system configuration, and does not request persistent system privileges. Default autonomy (disable-model-invocation:false) is normal and not by itself concerning.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install social-data - After installation, invoke the skill by name or use
/social-data - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
- Documentation restructured and retitled for clarity; metadata moved to a new summary section.
- Environment variable setup for the API key now specified more prominently and in table format.
- Previous notes and homepage links consolidated and streamlined.
- Core API endpoint, request/response structure, and usage examples remain unchanged.
- No underlying code or logic changes detected.
v1.0.3
-Update the api key defenition
v1.0.2
- Removed internal files: `macrocosmos_mcp/__init__.py` and `macrocosmos_mcp/macrocosmos_mcp.py`
- No changes to API documentation or user-facing guides
- No functional changes to the API usage or available endpoints
v1.0.1
- Removed file: macrocosmos_mcp/macrocosmos_mcp_sse.py
v1.0.0
- Initial release of the Macrocosmos SN13 skill for fetching real-time social data via API.
- Provides practical integration guide for retrieving X (Twitter) and Reddit content through Bittensor.
- Includes example API requests, full request/response schema, and best practices for reliable data retrieval.
- Covers both quick queries (OnDemandData) and large-scale dataset workflows (Gravity API).
- Contains sample code for SDK and REST usage, plus troubleshooting tips for common query issues.
Metadata
Frequently Asked Questions
What is Macrocosmos?
Fetch real-time social media data from X (Twitter) and Reddit by keyword, username, date range, and filters with engagement metrics via Macrocosmos SN13 API. It is an AI Agent Skill for Claude Code / OpenClaw, with 645 downloads so far.
How do I install Macrocosmos?
Run "/install social-data" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Macrocosmos free?
Yes, Macrocosmos is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Macrocosmos support?
Macrocosmos is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Macrocosmos?
It is built and maintained by Arrmlet (@arrmlet); the current version is v1.0.4.
More Skills