Social Data

What This Skill Does

The Macrocosmos Social Data skill provides OpenClaw agents with the ability to fetch real-time data from X (formerly Twitter) and Reddit via the Macrocosmos SN13 API on the Bittensor network. By integrating this skill, your agent can perform sophisticated market analysis, track sentiment across social platforms, and retrieve historical data points. It handles complex queries by filtering through keywords, specific user handles, and custom date ranges, allowing for highly targeted information retrieval. The skill communicates directly with the Macrocosmos API using a secure Bearer token, ensuring that all data requests are authenticated and authorized via your private MC_API key.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/arrmlet/social-data

Once installed, you must configure your environment to include the required authentication key. Set the MC_API environment variable to your unique key obtained from the Macrocosmos portal. Without this key, the agent will be unable to authenticate with the SN13 endpoint, and all data retrieval requests will fail.

Use Cases

This skill is ideal for quantitative and qualitative research. Common use cases include:

1. Sentiment Analysis: Monitoring community feedback on specific cryptocurrency projects or AI research papers.
2. Brand Monitoring: Tracking brand mentions or hashtag usage across X and Reddit to gauge audience reach.
3. Trend Identification: Detecting early mentions of trending topics by filtering for specific keywords over designated time windows.
4. Research Automation: Automating the collection of data for academic or market reports without manual scraping.

Example Prompts

• "Fetch the last 20 posts from @elonmusk related to AI and bittensor from the last month and summarize the sentiment."
• "Search Reddit for 'macrocosmos' in r/bittensor and return the top 5 results for the last 48 hours."
• "Get all tweets mentioning 'AI' from the last week, matching all keywords, and format them into a CSV-ready list."

Tips & Limitations

To maximize the utility of this skill, be mindful of the API's constraints. You are limited to 5 keywords or usernames per request. When searching Reddit, ensure you use the r/subreddit syntax in the keyword field to direct your search appropriately. The default limit is 10 results, but you can request up to 1000 items per call. Always remember to set your MC_API secret securely and avoid exposing it in plain text configuration files. Finally, be aware that results depend on the availability and indexing status of the underlying Macrocosmos SN13 decentralized data infrastructure.