{"slug":"social-sentiment-analyzer","title":"social-sentiment-analyzer","summary":"Analyze brand or topic sentiment across Twitter, Reddit, and Instagram using Xpoz. Classifies posts as positive/neutral/negative, extracts recurring themes, and generates a sentiment report. Use when asked for \"sentiment analysis\", \"what are people saying about X\", \"brand sentime","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-14T21:09:17.980256Z","repo":{"url":"https://github.com/XPOZpublic/xpoz-agent-skills","stars":15,"forks":3,"license":"MIT","updatedAt":"2026-09-09T13:52:40Z"},"bodyHtml":"
\n

name: social-sentiment-analyzer\nversion: 2026-02-24\ndescription: Analyze brand or topic sentiment across Twitter, Reddit, and Instagram using Xpoz. Classifies posts as positive/neutral/negative, extracts recurring themes, and generates a sentiment report. Use when asked for \"sentiment analysis\", \"what are people saying about X\", \"brand sentiment\", or \"social media opinion on X\".

\n

Social Sentiment Analyzer

\n

Overview

\n

Analyze public sentiment for any brand, product, or topic across Twitter/X, Reddit, and Instagram. Fetches real posts, classifies sentiment, extracts themes, and produces a structured report.

\n

When to Use

\n

Activate when the user asks:

\n\n

Setup & Authentication

\n

Before fetching data, ensure Xpoz access is configured. Follow these checks in order.

\n

Check 1: Already authenticated?

\n

If you have MCP tools, try calling any Xpoz tool (e.g., checkAccessKeyStatus). If it works → skip to Step 1.

\n

If you have the SDK, try:

\n
from xpoz import XpozClient\nclient = XpozClient()  # reads XPOZ_API_KEY env var\n
\n

If this succeeds without error → skip to Step 1.

\n

If neither works, you need to authenticate. Get a free access key (below).

\n
\n

Recommended: a free access key

\n

Real analyses need a real key: get a free access key (free tier, up to 75K results, no credit card). SDK and CLI users set it as XPOZ_API_KEY; MCP connections sign in with the same account via OAuth on first tool call (paths below).

\n
\n

Path A: MCP via mcporter (OpenClaw agents)

\n

If mcporter is available:

\n
mcporter call xpoz.checkAccessKeyStatus\n
\n

If hasAccessKey: true → ready. If not:

\n
mcporter config add xpoz https://mcp.xpoz.ai/mcp --auth oauth\n
\n

Then authenticate — generate the OAuth URL and send it to the user:

\n

Step 1: Generate authorization URL

\n
import secrets, hashlib, base64, urllib.parse, json, urllib.request, os\n\nverifier = secrets.token_urlsafe(64)\nchallenge = base64.urlsafe_b64encode(hashlib.sha256(verifier.encode()).digest()).rstrip(b'=').decode()\nstate = secrets.token_urlsafe(32)\n\n# Dynamic client registration\nreg_req = urllib.request.Request(\n    'https://mcp.xpoz.ai/oauth/register',\n    data=json.dumps({\n        'client_name': 'Agent Skills',\n        'redirect_uris': ['https://www.xpoz.ai/oauth/openclaw'],\n        'grant_types': ['authorization_code'],\n        'response_types': ['code'],\n        'token_endpoint_auth_method': 'none',\n    }).encode(),\n    headers={'Content-Type': 'application/json'},\n)\nreg_resp = json.loads(urllib.request.urlopen(reg_req).read())\n\nparams = urllib.parse.urlencode({\n    'response_type': 'code',\n    'client_id': reg_resp['client_id'],\n    'code_challenge': challenge,\n    'code_challenge_method': 'S256',\n    'redirect_uri': 'https://www.xpoz.ai/oauth/openclaw',\n    'state': state,\n    'scope': 'mcp:tools',\n    'resource': 'https://mcp.xpoz.ai/',\n})\n\nauth_url = 'https://mcp.xpoz.ai/oauth/authorize?' + params\n\n# Save state for token exchange\nos.makedirs(os.path.expanduser('~/.cache/xpoz-oauth'), exist_ok=True)\nwith open(os.path.expanduser('~/.cache/xpoz-oauth/state.json'), 'w') as f:\n    json.dump({'verifier': verifier, 'state': state, 'client_id': reg_resp['client_id'],\n               'redirect_uri': 'https://www.xpoz.ai/oauth/openclaw'}, f)\n\nprint(auth_url)\n
\n

Step 2: Send the URL to the user

\n

Tell them:

\n
\n

\"I need to connect to Xpoz for social media data. Please open this link and sign in:

\n

[auth_url]

\n

After authorizing, you'll see a code. Paste it back to me here.\"

\n
\n

Step 3: WAIT for the user to reply with the code. Do not proceed until they respond.

\n

Step 4: Exchange the code for a token

\n

Once the user provides the code (either a raw code or a URL containing ?code=...), extract the code and exchange it:

\n
import json, urllib.request, urllib.parse, subprocess, os\n\nwith open(os.path.expanduser('~/.cache/xpoz-oauth/state.json')) as f:\n    oauth = json.load(f)\n\ncode = \"THE_CODE_FROM_USER\"  # Extract from user's reply\n\ndata = urllib.parse.urlencode({\n    'grant_type': 'authorization_code',\n    'code': code,\n    'redirect_uri': oauth['redirect_uri'],\n    'client_id': oauth['client_id'],\n    'code_verifier': oauth['verifier'],\n}).encode()\n\nreq = urllib.request.Request(\n    'https://mcp.xpoz.ai/oauth/token',\n    data=data,\n    headers={'Content-Type': 'application/x-www-form-urlencoded'},\n)\nresp = json.loads(urllib.request.urlopen(req).read())\ntoken = resp['access_token']\n\n# Configure mcporter with the token (token is never printed)\nsubprocess.run(['mcporter', 'config', 'remove', 'xpoz'], capture_output=True)\nsubprocess.run(['mcporter', 'config', 'add', 'xpoz', 'https://mcp.xpoz.ai/mcp',\n                '--header', f'Authorization=Bearer {token}'], check=True)\n\n# Clean up\nos.remove(os.path.expanduser('~/.cache/xpoz-oauth/state.json'))\nprint(\"Xpoz configured successfully\")\n
\n

Step 5: Verify with mcporter call xpoz.checkAccessKeyStatus → should return hasAccessKey: true.

\n
\n

Path B: MCP via Claude Code

\n

For Claude Code users without mcporter:

\n
claude mcp add --transport http xpoz https://mcp.xpoz.ai/mcp\n
\n

Claude Code handles OAuth automatically on first tool call — the user just needs to authorize in their browser when prompted.

\n
\n

Path C: SDK (Python or TypeScript)

\n

Ask the user:

\n
\n

\"I need a Xpoz API key to access social media data. Please go to https://xpoz.ai/get-token (it's free, no credit card needed) and paste the key back to me.\"

\n
\n

WAIT for the user to reply with the key. Then:

\n

Python:

\n
pip install xpoz\n
\n
from xpoz import XpozClient\nclient = XpozClient(\"THE_KEY_FROM_USER\")\n
\n

TypeScript:

\n
npm install @xpoz/xpoz\n
\n
import { XpozClient } from \"@xpoz/xpoz\";\nconst client = new XpozClient({ apiKey: \"THE_KEY_FROM_USER\" });\nawait client.connect();\n
\n

Or set the environment variable and use the default constructor:

\n
export XPOZ_API_KEY=THE_KEY_FROM_USER\n
\n
\n

Auth Errors

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ProblemSolution
MCP: \"Unauthorized\"Re-run the OAuth flow above
SDK: AuthenticationErrorVerify key at xpoz.ai/settings
Token exchange failsAsk user to re-authorize — codes are single-use
\n

Step-by-Step Instructions

\n

Step 1: Parse the Request

\n

Extract from the user's message:

\n\n

Expand the query for better coverage:

\n\n

Step 2: Fetch Posts

\n

Via MCP (if xpoz MCP server is configured)

\n

Twitter:

\n
Call getTwitterPostsByKeywords:\n  query: \"<expanded query>\"\n  fields: [\"id\", \"text\", \"authorUsername\", \"createdAtDate\", \"likeCount\", \"retweetCount\", \"impressionCount\"]\n  startDate: \"<7 days ago, YYYY-MM-DD>\"\n  endDate: \"<today, YYYY-MM-DD>\"\n  language: \"en\"\n
\n

Reddit:

\n
Call getRedditPostsByKeywords:\n  query: \"<expanded query>\"\n  fields: [\"id\", \"title\", \"text\", \"authorUsername\", \"createdAtDate\", \"score\", \"numComments\", \"subreddit\"]\n  startDate: \"<7 days ago>\"\n  endDate: \"<today>\"\n
\n

Instagram (if requested):

\n
Call getInstagramPostsByKeywords:\n  query: \"<expanded query>\"\n  fields: [\"id\", \"text\", \"authorUsername\", \"createdAtDate\", \"likeCount\", \"commentCount\"]\n  startDate: \"<7 days ago>\"\n  endDate: \"<today>\"\n
\n

CRITICAL: Async Pattern — Each call returns an operationId. You MUST call checkOperationStatus with that ID and poll until status is \"completed\" (up to 8 retries, ~5 seconds apart).

\n

Via Python SDK

\n
from xpoz import XpozClient\n\nclient = XpozClient()  # Uses XPOZ_API_KEY env var\n\n# Twitter\ntwitter_results = client.twitter.search_posts(\n    '\"Tesla\" OR \"$TSLA\"',\n    start_date=\"2026-02-16\",\n    end_date=\"2026-02-23\",\n    language=\"en\",\n    fields=[\"id\", \"text\", \"author_username\", \"created_at_date\", \"like_count\", \"retweet_count\"]\n)\n\n# Reddit\nreddit_results = client.reddit.search_posts(\n    '\"Tesla\" OR \"$TSLA\"',\n    start_date=\"2026-02-16\",\n    end_date=\"2026-02-23\",\n    fields=[\"id\", \"title\", \"text\", \"author_username\", \"created_at_date\", \"score\", \"num_comments\", \"subreddit\"]\n)\n\n# Collect all posts\ntwitter_posts = twitter_results.data\nreddit_posts = reddit_results.data\n\n# Fetch additional pages if needed\nwhile twitter_results.has_next_page():\n    twitter_results = twitter_results.next_page()\n    twitter_posts.extend(twitter_results.data)\n\nclient.close()\n
\n

Via TypeScript SDK

\n
import { XpozClient } from \"@xpoz/xpoz\";\n\nconst client = new XpozClient();\nawait client.connect();\n\nconst twitterResults = await client.twitter.searchPosts('\"Tesla\" OR \"$TSLA\"', {\n  startDate: \"2026-02-16\",\n  endDate: \"2026-02-23\",\n  language: \"en\",\n  fields: [\"id\", \"text\", \"authorUsername\", \"createdAtDate\", \"likeCount\", \"retweetCount\"],\n});\n\nconst redditResults = await client.reddit.searchPosts('\"Tesla\" OR \"$TSLA\"', {\n  startDate: \"2026-02-16\",\n  endDate: \"2026-02-23\",\n  fields: [\"id\", \"title\", \"text\", \"authorUsername\", \"createdAtDate\", \"score\", \"numComments\", \"subreddit\"],\n});\n\nawait client.close();\n
\n

Step 3: Classify Sentiment

\n

For each post, classify into one of 5 levels:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
LevelIndicators
Positive\"love\", \"amazing\", \"bullish\", \"great\", \"best\", \uD83D\uDE80\uD83D\uDD25\uD83D\uDCAA, strong praise
Leaning Positive\"looking good\", \"solid\", \"promising\", measured optimism
NeutralQuestions, factual statements, news without opinion, balanced takes
Leaning Negative\"worried\", \"not sure\", \"concerned\", \"some issues\", cautious criticism
Negative\"terrible\", \"worst\", \"avoid\", \"bearish\", \uD83D\uDCC9\uD83D\uDC80, strong criticism
\n

Tips:

\n\n

Step 4: Extract Themes

\n

Identify 5-8 recurring themes from the posts. For each theme:

\n\n

Step 5: Generate Report

\n

Present results in this structure:

\n
## Sentiment Report: [TOPIC]\n**Period:** [start] to [end] | **Posts analyzed:** [count]\n\n### Overall Sentiment\nScore: [0-100, where 50=neutral, 100=max positive]\n- Positive: X%\n- Neutral: X%\n- Negative: X%\n\n### Platform Breakdown\n| Platform | Posts | Sentiment Score | Top Theme |\n|----------|-------|----------------|-----------|\n| Twitter  | X     | X              | ...       |\n| Reddit   | X     | X              | ...       |\n\n### Key Themes\n1. **[Theme Title]** (Positive/Neutral/Negative)\n   [2-3 sentence explanation with example quotes]\n\n2. **[Theme Title]** ...\n\n### Notable Posts\n[Top 5 highest-engagement posts with text, author, and metrics]\n\n### Summary\n[2-3 paragraph executive summary with actionable insights]\n
\n

Example Prompts

\n\n

Notes

\n\n","files":[{"path":"SKILL.md","sizeBytes":12106,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-14T21:09:28.562439Z","sha256":"4489DD21B0CB23EE58543B68092F87754CBC408B37C133A99CE0820C264B5031","sizeBytes":4861},"review":null,"source":{"repositoryUrl":"https://github.com/XPOZpublic/xpoz-agent-skills","path":"skills/social-sentiment-analyzer","license":"MIT","commit":"d18bc4b4b44f73c644da771fb3408b569481fd99","subtreeSha":"402B83BB57559AD639BB052B7237C456830DCCB13CA8021D369EB054F7E57EA6","lastSyncedAt":"2026-09-19T13:50:20.313802Z"},"reviewedAt":"2026-09-14T21:10:54.986838Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/XPOZpublic/xpoz-agent-skills/tree/main/skills/social-sentiment-analyzer"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install xpozpublic-xpoz-agent-skills@llmmart"},{"target":"git","command":"git clone https://github.com/XPOZpublic/xpoz-agent-skills.git"}]}