![\"OpenClaw](\"https://img.shields.io/badge/OpenClaw-Skill-2563EB?style=for-the-badge\"){kind=icon}
\n ![\"v1.0.0\"](\"https://img.shields.io/badge/Version-1.0.0-8B5CF6?style=for-the-badge\"){kind=icon}
\n ![\"MIT](\"https://img.shields.io/badge/License-MIT-22C55E?style=for-the-badge\"){kind=icon}
\n\n
\n Social Media Intelligence Skill for OpenClaw Agents
\n Real-time sentiment analysis, trend detection, influencer tracking, and bot detection
\n powered by Verosight API.\n
\n ClawHub ·\n Verosight API ·\n OpenClaw\n
\n\n---\n\n## What Is This?\n\nVerosight Monitor is an OpenClaw skill that integrates the [Verosight API](https://verosight.com) for real-time social media intelligence. It enables AI agents to perform sentiment analysis, track trends, identify influencers, and detect bot activity across major social media platforms.\n\n### Supported Platforms\n\n| Platform | Data Available |\n|----------|---------------|\n| **X (Twitter)** | Posts, replies, engagement metrics |\n| **Instagram** | Posts, captions, engagement |\n| **TikTok** | Videos, descriptions, views |\n| **YouTube** | Videos, comments, engagement |\n| **Threads** | Posts, replies, engagement |\n| **Facebook** | Posts, pages |\n| **LinkedIn** | Posts, articles |\n| **News Portals** | Indonesian media articles |\n\n## Features\n\n- 📊 **Sentiment Analysis** — Positive/negative/neutral breakdown with engagement-weighted scoring\n- 📈 **Trend Detection** — Volume tracking over time with daily breakdowns\n- 👤 **Influencer Identification** — Find the most vocal and impactful accounts\n- 🤖 **Bot Detection** — Identify coordinated posting patterns and inauthentic behavior\n- 📄 **PDF Reports** — Professional reports with tables, charts, and formatted layouts\n- 🌐 **Multi-Platform** — Monitor across 8+ platforms simultaneously\n- ⚡ **Real-Time** — Live data from social media and news sources\n\n## Quick Start\n\n### Prerequisites\n\n- [OpenClaw](https://github.com/openclaw/openclaw) agent instance\n- Verosight API key ([sign up here](https://verosight.com))\n\n### Installation\n\n```bash\n# Via ClawHub (recommended)\nclawhub install verosight-monitor\n\n# Or clone manually\ngit clone https://github.com/jrrqd/verosight-monitor.git\ncp -r verosight-monitor ~/.openclaw/workspace/skills/\n```\n\n### Get Your API Key\n\n1. Sign up at [verosight.com](https://verosight.com)\n2. Go to [API Keys](https://verosight.com/dashboard/keys)\n3. Generate a new key (starts with `vlt_live_`)\n\n### Authenticate\n\n```bash\n# Exchange API key for JWT token (valid 24h)\nJWT=$(curl -s -X POST \"https://api.verosight.com/v1/auth/token\" \\\n -H \"X-API-Key: vlt_live_YOUR_KEY\" | jq -r '.token')\n```\n\n### Your First Query\n\n```bash\n# Sentiment analysis\ncurl -s \"https://api.verosight.com/v1/analytics/sentiment?query=your_keyword&sources=x,instagram&days=7\" \\\n -H \"Authorization: Bearer $JWT\" | jq .\n```\n\n## API Reference\n\n### Posts\n\n```bash\n# Search posts\nGET /v1/posts?query=KEYWORD&sources=x,instagram&limit=10&days=7\n\n# Get single post\nGET /v1/posts/:id\n\n# Get comments\nGET /v1/posts/:id/comments\n```\n\n### Analytics\n\n```bash\n# Sentiment analysis\nGET /v1/analytics/sentiment?query=KEYWORD&sources=x,instagram&days=7\n\n# Volume over time\nGET /v1/analytics/volume?query=KEYWORD&days=7\n\n# Trending posts/profiles\nGET /v1/analytics/trending?query=KEYWORD&limit=10\n```\n\n### Profiles\n\n```bash\n# Search profiles\nGET /v1/profiles?query=ACCOUNT&source=instagram\n\n# Profile details\nGET /v1/profiles/:source/:account\n\n# Engagement stats\nGET /v1/profiles/:source/:account/stats\n```\n\n### Account\n\n```bash\n# Check balance (free)\nGET /v1/account/balance\n\n# Usage history (free)\nGET /v1/account/usage\n```\n\n## Use Cases\n\n| Use Case | Description |\n|----------|-------------|\n| **Digital Reputation Management** | Monitor brand mentions and sentiment in real-time |\n| **Crisis Detection** | Early warning for negative viral content |\n| **Competitor Analysis** | Track competitor mentions and public perception |\n| **Influencer Marketing** | Identify key voices and opinion leaders |\n| **Political Monitoring** | Track public opinion on policies and events |\n| **Bot Detection** | Identify coordinated inauthentic behavior networks |\n\n## Project Structure\n\n```\nverosight-monitor/\n├── SKILL.md # OpenClaw skill instructions\n├── README.md # This file\n├── LICENSE # MIT License\n├── references/\n│ ├── sentiment-workflow.md # Step-by-step sentiment analysis guide\n│ └── pdf-template.md # PDF report generation with pdfkit\n└── scripts/\n ├── verosight-auth.sh # Auth helper (API key → JWT)\n └── quick-sentiment.sh # Quick sentiment check CLI\n```\n\n## Credit System\n\nEach API call costs credits based on the endpoint:\n\n| Endpoint | Cost |\n|----------|------|\n| Posts search | 2 credits |\n| Sentiment analysis | 5 credits |\n| Volume analytics | 5 credits |\n| Trending | 5 credits |\n| Profile search | 2 credits |\n| Account balance | 0 credits |\n\nFree accounts start with **1,000 credits**. Failed requests (4xx/5xx) do not deduct credits.\n\n## Rate Limits\n\n| Tier | Limit |\n|------|-------|\n| Standard | 60 requests/minute |\n| Pro | 300 requests/minute |\n| Enterprise | Custom |\n\n## Contributing\n\nContributions are welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.\n\n## Links\n\n- [Verosight API](https://verosight.com) — API documentation and dashboard\n- [ClawHub](https://clawhub.com) — OpenClaw skill marketplace\n- [OpenClaw](https://github.com/openclaw/openclaw) — Open-source AI agent runtime\n- [Slameticon Digital Valley](https://slameticon.com) — Cyber monitoring platform\n\n---\n\n\n Built with 🔍 by Slameticon Digital Valley\n
\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn7f5gtk7twvcw8bvhenbr0q5x83yqth\",\n \"slug\": \"verosight-monitor\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1774930274100\n}\n\nFile v1.0.1:references/pdf-template.md\n\n# PDF Report Generation with pdfkit\n\nGenerate professional PDF reports with tables, charts, and formatted layouts using Node.js pdfkit.\n\n## Installation\n\n```bash\nnpm install pdfkit\n```\n\n## Basic Structure\n\n```javascript\nconst PDFDocument = require('pdfkit');\nconst fs = require('fs');\n\nconst doc = new PDFDocument({ \n size: 'A4', \n margin: 45,\n info: {\n Title: 'Report Title',\n Author: 'SDVM',\n Subject: 'Report Subject'\n }\n});\n\ndoc.pipe(fs.createWriteStream('report.pdf'));\n\n// Page constants\nconst PAGE_W = 595.28; // A4 width in points\nconst MG = 45; // Margin\nconst CW = PAGE_W - (MG * 2); // Content width: 505\nconst PAGE_H = 841.89; // A4 height in points\nconst BOT = PAGE_H - 55; // Bottom limit\n\n// State\nlet pg = 1; // Page number\nlet y = 0; // Current Y position\n```\n\n## Page Management\n\n```javascript\nfunction newPage() {\n doc.addPage();\n pg++;\n y = MG;\n // Header\n doc.fontSize(7).fillColor('#6B7280').text('Your Brand', MG, MG - 12);\n doc.moveTo(MG, MG + 2).lineTo(PAGE_W - MG, MG + 2)\n .strokeColor('#E5E7EB').lineWidth(0.5).stroke();\n y = MG + 12;\n}\n\nfunction footer() {\n doc.fontSize(7).fillColor('#6B7280')\n .text(`Page ${pg}`, MG, PAGE_H - 30, { align: 'center', width: CW });\n}\n\nfunction need(h = 60) {\n if (y + h > BOT) { footer(); newPage(); }\n}\n```\n\n## Drawing Functions\n\n### Section Title\n\n```javascript\nfunction title(text) {\n need(45);\n doc.fontSize(13).fillColor('#1F2937').text(text, MG, y);\n const tw = doc.widthOfString(text);\n doc.moveTo(MG, y + 16).lineTo(MG + tw + 8, y + 16)\n .strokeColor('#2563EB').lineWidth(1.5).stroke();\n y += 28;\n}\n```\n\n### Paragraph\n\n```javascript\nfunction para(text, indent = 0) {\n const w = CW - indent;\n doc.fontSize(9);\n const h = doc.heightOfString(text, { width: w });\n need(h + 6);\n doc.fillColor('#1F2937').text(text, MG + indent, y, { width: w, lineGap: 1 });\n y += h + 6;\n}\n```\n\n### Bullet List\n\n```javascript\nfunction bullet(text, indent = 18) {\n const w = CW - indent;\n doc.fontSize(9);\n const h = doc.heightOfString(text, { width: w });\n need(h + 5);\n doc.fillColor('#2563EB').text('●', MG, y);\n doc.fillColor('#1F2937').text(text, MG + indent, y, { width: w, lineGap: 1 });\n y += h + 5;\n}\n```\n\n### Info Box (measures text height FIRST, then draws box)\n\n```javascript\nfunction infoBox(text, bg = '#FEF2F2', border = '#DC2626') {\n const pad = 12;\n const w = CW - pad * 2;\n doc.fontSize(9);\n \n // Calculate height FIRST\n const textH = doc.heightOfString(text, { width: w, lineGap: 1 });\n const boxH = textH + pad * 2;\n need(boxH + 10);\n \n // Then draw\n doc.fillColor(bg).rect(MG, y, CW, boxH).fill();\n doc.rect(MG, y, CW, boxH).strokeColor(border).lineWidth(1).stroke();\n doc.fillColor('#1F2937').text(text, MG + pad, y + pad, { width: w, lineGap: 1 });\n y += boxH + 12;\n}\n```\n\n### Data Table (auto row height calculation)\n\n```javascript\nfunction table(headers, rows, colW) {\n const pad = 6;\n const fs = 8;\n const hdrH = 24;\n \n doc.fontSize(fs);\n \n // Pre-calculate all row heights\n const rowH = rows.map(row => {\n let maxH = 22;\n row.forEach((cell, ci) => {\n const h = doc.heightOfString(cell || '', { \n width: colW[ci] - pad * 2, \n lineGap: 1 \n });\n const cellH = h + pad * 2;\n if (cellH > maxH) maxH = cellH;\n });\n return maxH;\n });\n \n const totalH = hdrH + rowH.reduce((a, b) => a + b, 0);\n need(totalH + 15);\n \n let ty = y;\n \n // Draw header\n doc.fillColor('#EFF6FF').rect(MG, ty, CW, hdrH).fill();\n doc.rect(MG, ty, CW, hdrH).strokeColor('#E5E7EB').lineWidth(0.5).stroke();\n let cx = MG + pad;\n headers.forEach((h, i) => {\n doc.fontSize(fs).fillColor('#1F2937')\n .text(h, cx, ty + pad + 2, { width: colW[i] - pad * 2, lineBreak: false });\n cx += colW[i];\n });\n ty += hdrH;\n \n // Draw rows\n rows.forEach((row, ri) => {\n const rh = rowH[ri];\n if (ri % 2 === 0) {\n doc.fillColor('#F9FAFB').rect(MG, ty, CW, rh).fill();\n }\n doc.rect(MG, ty, CW, rh).strokeColor('#E5E7EB').lineWidth(0.5).stroke();\n \n let rx = MG + pad;\n doc.fontSize(fs).fillColor('#1F2937');\n row.forEach((cell, ci) => {\n doc.text(cell || '', rx, ty + pad, { \n width: colW[ci] - pad * 2,\n lineGap: 1\n });\n rx += colW[ci];\n });\n ty += rh;\n });\n \n y = ty + 10;\n}\n```\n\n### Bar Chart\n\n```javascript\nfunction barChart(items, maxVal) {\n const barH = 24;\n const barMaxW = 300;\n const lblW = 60;\n \n need(items.length * (barH + 10) + 15);\n \n items.forEach(item => {\n const bw = Math.max(0, (item.value / maxVal) * barMaxW);\n \n // Label\n doc.fontSize(9).fillColor('#1F2937')\n .text(item.label, MG, y + 6, { width: lblW });\n \n // Background bar\n doc.fillColor('#F3F4F6')\n .rect(MG + lblW, y, barMaxW, barH).fill();\n \n // Value bar\n if (bw > 0) {\n doc.fillColor(item.color || '#2563EB')\n .rect(MG + lblW, y, bw, barH).fill();\n }\n \n // Value text\n const valText = item.value.toLocaleString();\n doc.fontSize(9)\n .fillColor(bw > 55 ? '#FFFFFF' : '#1F2937')\n .text(valText, MG + lblW + 6, y + 6, { \n width: Math.max(bw - 12, 40) \n });\n \n // Percentage (optional)\n if (item.pct) {\n doc.fontSize(8).fillColor('#6B7280')\n .text(item.pct, MG + lblW + barMaxW + 10, y + 7);\n }\n \n y += barH + 10;\n });\n \n // Reset spacing\n y += 5;\n}\n```\n\n## Color Palette\n\n```javascript\nconst C = {\n red: '#DC2626', // Danger, critical alerts\n orange: '#EA580C', // Warnings\n green: '#16A34A', // Positive, success\n blue: '#2563EB', // Primary, links\n gray: '#6B7280', // Secondary text\n dark: '#1F2937', // Primary text\n lightGray: '#E5E7EB', // Borders\n lighterGray: '#F3F4F6', // Backgrounds\n white: '#FFFFFF',\n headerBg: '#EFF6FF', // Table header\n rowAlt: '#F9FAFB', // Alternating row\n dangerBg: '#FEF2F2' // Alert box\n};\n```\n\n## Common Pitfalls\n\n1. **Text overlap** — Always calculate text height BEFORE drawing boxes/containers. Use `doc.heightOfString()` first, then draw the box with that height.\n\n2. **Row height in tables** — Pre-calculate ALL row heights before drawing. Use the maximum height per row across all columns.\n\n3. **Page breaks** — Always call `need()` before drawing any multi-line element (tables, charts, info boxes).\n\n4. **Line gap** — Use `lineGap: 1` option for multi-line text to prevent crowding between lines.\n\n5. **Credit/secret info** — Remove internal API details (credits, keys, tokens) from client-facing reports.\n\n6. **Column widths** — Ensure column widths sum to content width. Test with long text to verify wrapping.\n\n7. **Font sizing** — Keep body text at 9pt minimum for readability in print.\n\n## Complete Example\n\n```javascript\nconst PDFDocument = require('pdfkit');\nconst fs = require('fs');\n\nconst doc = new PDFDocument({ size: 'A4', margin: 45 });\ndoc.pipe(fs.createWriteStream('output.pdf'));\n\nconst MG = 45, CW = 505, BOT = 786;\nlet pg = 1, y = MG;\n\n// ... include all helper functions above ...\n\n// Page 1\ntitle('Executive Summary');\ninfoBox('Status: CRITICAL — 60% negative sentiment detected across platforms.');\n\ntitle('Key Metrics');\ntable(\n ['Metric', 'Value', 'Change', 'Status'],\n [\n ['Total Posts', '8,251', '+33%', 'High'],\n ['Negative', '3,300', '+45%', 'Critical'],\n ['Positive', '0', '-100%', 'None'],\n ],\n [120, 80, 80, 225]\n);\n\ntitle('Volume Trend');\nbarChart([\n { label: 'Day 1', value: 3490, color: '#3B82F6', pct: '33%' },\n { label: 'Day 2', value: 4646, color: '#EF4444', pct: '44%' },\n { label: 'Day 3', value: 115, color: '#9CA3AF', pct: '1%' },\n], 4600);\n\nfooter();\ndoc.end();\n```\n\nFile v1.0.1:references/sentiment-workflow.md\n\n# Sentiment Analysis Workflow\n\nComplete workflow for conducting sentiment analysis using the Verosight API.\n\n## Step 1: Authentication\n\n```bash\n# Set your API key\nexport VEROSIGHT_API_KEY=\"vlt_live_YOUR_KEY\"\n\n# Get JWT token (valid 24h)\nJWT=$(curl -s -X POST \"https://api.verosight.com/v1/auth/token\" \\\n -H \"X-API-Key: $VEROSIGHT_API_KEY\" | jq -r '.token')\n\n# Verify token works\ncurl -s \"https://api.verosight.com/v1/account/balance\" \\\n -H \"Authorization: Bearer $JWT\"\n```\n\n## Step 2: Get Sentiment Data\n\n```bash\ncurl -s \"https://api.verosight.com/v1/analytics/sentiment?query=KEYWORD&sources=x,instagram,tiktok&days=7\" \\\n -H \"Authorization: Bearer $JWT\" | jq .\n```\n\n### Response Fields\n\n| Field | Description |\n|-------|-------------|\n| `positive` / `negative` / `neutral` | Post counts by sentiment |\n| `positive_pct` / `negative_pct` / `neutral_pct` | Percentage breakdown |\n| `weighted_positive_pct` / `weighted_negative_pct` | Engagement-weighted percentages |\n| `sample_positive` / `sample_negative` | Sample posts with engagement data |\n| `sample_independent_negative` | Social media comments with negative sentiment |\n| `post_positive` / `post_negative` / `post_neutral` | Post-level sentiment counts |\n| `thread_positive` / `thread_negative` | Thread-level sentiment counts |\n| `independent_positive` / `independent_negative` | Independent comment sentiment |\n\n## Step 3: Get Volume Trend\n\n```bash\ncurl -s \"https://api.verosight.com/v1/analytics/volume?query=KEYWORD&days=7\" \\\n -H \"Authorization: Bearer $JWT\" | jq .\n```\n\nReturns daily breakdown of posts and comments by platform.\n\n## Step 4: Get High-Engagement Posts\n\n```bash\n# Negative posts from X\ncurl -s \"https://api.verosight.com/v1/posts?query=KEYWORD&sources=x&sentiment=negative&limit=15&days=7\" \\\n -H \"Authorization: Bearer $JWT\" | jq .\n\n# All posts from specific platforms\ncurl -s \"https://api.verosight.com/v1/posts?query=KEYWORD&sources=x,threads&limit=20&days=7\" \\\n -H \"Authorization: Bearer $JWT\" | jq .\n```\n\n## Step 5: Compile Report\n\nUse the following structure for your report:\n\n### Report Template\n\n```markdown\n# 🔍 SDV REPORT\n## Keyword: \"[KEYWORD]\"\n**Period:** [START] – [END] | **Sources:** [PLATFORMS]\n\n---\n\n## 📊 SENTIMENT OVERVIEW\n\n| Sentiment | Count | % | Weighted |\n|-----------|-------|---|----------|\n| Positive | X | X%| X% |\n| Negative | X | X%| X% |\n| Neutral | X | X%| X% |\n\n**Status:** [CRITICAL / HIGH / MEDIUM / LOW]\n\n## 📈 VOLUME TREND\n\n| Date | Posts | Change |\n|------|-------|--------|\n| Day 1| X | - |\n| Day 2| X | +X% |\n\n## 🔴 TOP NEGATIVE NARRATIVES\n\n1. **[Narrative title]** — @account (Platform, X likes, X shares)\n - Full quote or summary\n\n2. **[Narrative title]** — @account (Platform, X likes)\n - Full quote or summary\n\n## 🟢 TOP POSITIVE NARRATIVES\n\n1. **[Narrative title]** — @account (Platform, X likes)\n - Full quote or summary\n\n## 👤 VOCAL ACCOUNTS (Negative)\n\n| Account | Platform | Engagement | Narrative |\n|---------|----------|------------|-----------|\n| @user1 | X | 500 likes | Topic A |\n| @user2 | Threads | 200 likes | Topic B |\n\n## 📡 PLATFORM BREAKDOWN\n\n| Platform | Volume | % | Engagement | Dominant Sentiment |\n|----------|--------|---|------------|-------------------|\n| News Portal | X | X% | Low | Factual |\n| X (Twitter) | X | X% | Medium | Opinion/criticism |\n| Threads | X | X% | HIGH | Emotional/viral |\n\n## 💡 INSIGHTS\n\n1. [Key finding about sentiment trend]\n2. [Key finding about narrative shift]\n3. [Key finding about platform dynamics]\n\n## ⚠️ PREDICTIONS (48h)\n\n| Risk | Probabil\n\nArchive v1.0.0: 7 files, 8240 bytes\n\nFiles: README.md (3442b), references/pdf-template.md (4040b), references/sentiment-workflow.md (2429b), scripts/quick-sentiment.sh (877b), scripts/verosight-auth.sh (666b), SKILL.md (3996b), _meta.json (136b)","readmeExcerpt":"Skill: Verosight Monitor Owner: jrrqd Summary: Integrate Verosight API for social media intelligence and cyber monitoring. Sentiment analysis, trend detection, influencer identification, and bot detection... Tags: latest:1.1.2 Version history: v1.1.2 | 2026-07-22T16:47:53.462Z | user Added MCP server support, 14+ platforms (Reddit, Darkweb, Capital Market), 30 MCP tools v1.1.1 | 2026-07-22T16:44:57.357Z | user Added ","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"JWT=$(curl -s -X POST \"https://api.verosight.com/v1/auth/token\" \\\n -H \"X-API-Key: vlt_live_YOUR_KEY\" | jq -r '.token')"},{"language":"bash","snippet":"./scripts/verosight-auth.sh vlt_live_YOUR_KEY"},{"language":"bash","snippet":"curl -s \"https://api.verosight.com/v1/analytics/sentiment?query=KEYWORD&sources=x,instagram&days=7\" \\\n -H \"Authorization: Bearer $JWT\""},{"language":"bash","snippet":"curl -s \"https://api.verosight.com/v1/posts?query=KEYWORD&sources=x,instagram&limit=10\" \\\n -H \"Authorization: Bearer $JWT\""},{"language":"bash","snippet":"# Sentiment analysis\ncurl -s \"https://api.verosight.com/v1/analytics/sentiment?query=KEYWORD&sources=x,instagram&days=7\" \\\n -H \"Authorization: Bearer $JWT\"\n\n# Search posts\ncurl -s \"https://api.verosight.com/v1/posts?query=KEYWORD&sources=x,instagram&limit=10\" \\\n -H \"Authorization: Bearer $JWT\""},{"language":"text","snippet":"GET /v1/posts"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: verosight-monitor\ndescription: \"Integrate Verosight API for social media intelligence and cyber monitoring. Sentiment analysis, trend detection, influencer identification, and bot detection across X (Twitter), Instagram, TikTok, YouTube, Threads, and news portals. Use when: user asks for sentiment analysis, social media monitoring, trend analysis, influencer tracking, bot detection, or mentions 'Verosight', 'social listening', 'cyber monitoring', 'digital reputation'. Covers auth setup, querying posts, analytics (sentiment/trending/volume), profile search, and report generation.\"\n---\n\n# Verosight Monitor — Social Media Intelligence Skill\n\nIntegrate Verosight API for real-time social media monitoring and digital reputation management across major platforms.\n\n## Quick Setup\n\n### 1. Get API Key\nSign up at [verosight.com](https://verosight.com) and generate an API key from the [API Keys dashboard](https://verosight.com/dashboard/keys). Keys start with `vlt_live_` (production) or `vlt_test_` (test).\n\n### 2. Authenticate\nExchange your API key for a JWT token (valid 24 hours):\n\n```bash\nJWT=$(curl -s -X POST \"https://api.verosight.com/v1/auth/token\" \\\n -H \"X-API-Key: vlt_live_YOUR_KEY\" | jq -r '.token')\n```\n\nOr use the bundled auth script:\n```bash\n./scripts/verosight-auth.sh vlt_live_YOUR_KEY\n```\n\n### 3. Query Data\n```bash\n# Sentiment analysis\ncurl -s \"https://api.verosight.com/v1/analytics/sentiment?query=KEYWORD&sources=x,instagram&days=7\" \\\n -H \"Authorization: Bearer $JWT\"\n\n# Search posts\ncurl -s \"https://api.verosight.com/v1/posts?query=KEYWORD&sources=x,instagram&limit=10\" \\\n -H \"Authorization: Bearer $JWT\"\n```\n\n## API Endpoints\n\n### Posts\n```\nGET /v1/posts\n```\nSearch posts across platforms with filters.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `query` | string | Search keyword |\n| `sources` | string | Comma-separated: `x,instagram,tiktok,youtube,threads,news_portal` |\n| `limit` | int | Results per page (default: 10, max: 50) |\n| `days` | int | Lookback period (1-90) |\n| `sentiment` | string | Filter: `positive`, `negative`, `neutral` |\n\n```\nGET /v1/posts/:id\n```\nGet a single post by ID.\n\n```\nGET /v1/posts/:id/comments\n```\nGet comments for a post.\n\n### Analytics\n```\nGET /v1/analytics/sentiment\n```\nSentiment analysis for a keyword. Returns positive/negative/neutral breakdown, weighted percentages, and sample posts.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `query` | string | Search keyword |\n| `sources` | string | Comma-separated platforms |\n| `days` | int | Lookback period |\n| `limit` | int | Number of sample posts to return |\n\n```\nGET /v1/analytics/volume\n```\nPost/comment volume over time (daily breakdown).\n\n```\nGET /v1/analytics/trending\n```\nTrending posts and profiles for a keyword.\n\n### Profiles\n```\nGET /v1/profiles?query=ACCOUNT&source=instagram\n```\nSearch for social media profiles.\n\n```\nGET /v1/profiles/:source/:account\n```\nGet profile details (auto-crawls if missing)."},{"path":"README.md","content":"# 🔍 Verosight Monitor\n\n**Social Media Intelligence Skill for OpenClaw Agents**\n\nReal-time sentiment analysis, trend detection, influencer tracking, and bot detection powered by [Verosight API](https://verosight.com).\n\n[](https://github.com/openclaw/openclaw)\n[](https://clawhub.com/skills/verosight-monitor)\n[](LICENSE)\n\n---\n\n## What Is This?\n\nVerosight Monitor is an OpenClaw skill that integrates the [Verosight API](https://verosight.com) for real-time social media intelligence. It enables AI agents to perform sentiment analysis, track trends, identify influencers, and detect bot activity across major social media platforms.\n\n### Supported Platforms\n\n- **X (Twitter)** — Posts, replies, engagement metrics\n- **Instagram** — Posts, captions, engagement\n- **TikTok** — Videos, descriptions, views\n- **YouTube** — Videos, comments, engagement\n- **Threads** — Posts, replies, engagement\n- **Facebook** — Posts, pages\n- **LinkedIn** — Posts, articles\n- **News Portals** — Indonesian media articles\n\n## Features\n\n- 📊 **Sentiment Analysis** — Positive/negative/neutral breakdown with engagement-weighted scoring\n- 📈 **Trend Detection** — Volume tracking over time with daily breakdowns\n- 👤 **Influencer Identification** — Find the most vocal and impactful accounts\n- 🤖 **Bot Detection** — Identify coordinated posting patterns and inauthentic behavior\n- 📄 **PDF Reports** — Professional reports with tables, charts, and formatted layouts\n- 🌐 **Multi-Platform** — Monitor across 8+ platforms simultaneously\n- ⚡ **Real-Time** — Live data from social media and news sources\n\n## Quick Start\n\n### Prerequisites\n\n- [OpenClaw](https://github.com/openclaw/openclaw) agent instance\n- Verosight API key ([sign up here](https://verosight.com))\n\n### Installation\n\n```bash\n# Via ClawHub (recommended)\nclawhub install verosight-monitor\n\n# Or clone manually\ngit clone https://github.com/jrrqd/verosight-monitor.git\ncp -r verosight-monitor ~/.openclaw/workspace/skills/\n```\n\n### Get Your API Key\n\n1. Sign up at [verosight.com](https://verosight.com)\n2. Go to [API Keys](https://verosight.com/dashboard/keys)\n3. Generate a new key (starts with `vlt_live_`)\n\n### Authenticate\n\n```bash\n# Exchange API key for JWT token (valid 24h)\nJWT=$(curl -s -X POST \"https://api.verosight.com/v1/auth/token\" \\\n -H \"X-API-Key: vlt_live_YOUR_KEY\" | jq -r '.token')\n```\n\n### Your First Query\n\n```bash\n# Sentiment analysis\ncurl -s \"https://api.verosight.com/v1/analytics/sentiment?query=your_keyword&sources=x,instagram&days=7\" \\\n -H \"Authorization: Bearer $JWT\" | jq .\n```\n\n## API Reference\n\n### Posts\n\n```bash\n# Search posts\nGET /v1/posts?query=KEYWORD&sources=x,instagram&limit=10&days=7\n\n# Get single post\nGET /v1/posts/:id\n\n# Get comments\nGET /v1/posts/:id/comments\n```\n\n##"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7f5gtk7twvcw8bvhenbr0q5x83yqth\",\n \"slug\": \"verosight-monitor\",\n \"version\": \"1.1.2\",\n \"publishedAt\": 1784738873462\n}"},{"path":"references/pdf-template.md","content":"# PDF Report Generation with pdfkit\n\nGenerate professional PDF reports with tables, charts, and formatted layouts using Node.js pdfkit.\n\n## Installation\n\n```bash\nnpm install pdfkit\n```\n\n## Basic Structure\n\n```javascript\nconst PDFDocument = require('pdfkit');\nconst fs = require('fs');\n\nconst doc = new PDFDocument({ \n size: 'A4', \n margin: 45,\n info: {\n Title: 'Report Title',\n Author: 'SDVM',\n Subject: 'Report Subject'\n }\n});\n\ndoc.pipe(fs.createWriteStream('report.pdf'));\n\n// Page constants\nconst PAGE_W = 595.28; // A4 width in points\nconst MG = 45; // Margin\nconst CW = PAGE_W - (MG * 2); // Content width: 505\nconst PAGE_H = 841.89; // A4 height in points\nconst BOT = PAGE_H - 55; // Bottom limit\n\n// State\nlet pg = 1; // Page number\nlet y = 0; // Current Y position\n```\n\n## Page Management\n\n```javascript\nfunction newPage() {\n doc.addPage();\n pg++;\n y = MG;\n // Header\n doc.fontSize(7).fillColor('#6B7280').text('Your Brand', MG, MG - 12);\n doc.moveTo(MG, MG + 2).lineTo(PAGE_W - MG, MG + 2)\n .strokeColor('#E5E7EB').lineWidth(0.5).stroke();\n y = MG + 12;\n}\n\nfunction footer() {\n doc.fontSize(7).fillColor('#6B7280')\n .text(`Page ${pg}`, MG, PAGE_H - 30, { align: 'center', width: CW });\n}\n\nfunction need(h = 60) {\n if (y + h > BOT) { footer(); newPage(); }\n}\n```\n\n## Drawing Functions\n\n### Section Title\n\n```javascript\nfunction title(text) {\n need(45);\n doc.fontSize(13).fillColor('#1F2937').text(text, MG, y);\n const tw = doc.widthOfString(text);\n doc.moveTo(MG, y + 16).lineTo(MG + tw + 8, y + 16)\n .strokeColor('#2563EB').lineWidth(1.5).stroke();\n y += 28;\n}\n```\n\n### Paragraph\n\n```javascript\nfunction para(text, indent = 0) {\n const w = CW - indent;\n doc.fontSize(9);\n const h = doc.heightOfString(text, { width: w });\n need(h + 6);\n doc.fillColor('#1F2937').text(text, MG + indent, y, { width: w, lineGap: 1 });\n y += h + 6;\n}\n```\n\n### Bullet List\n\n```javascript\nfunction bullet(text, indent = 18) {\n const w = CW - indent;\n doc.fontSize(9);\n const h = doc.heightOfString(text, { width: w });\n need(h + 5);\n doc.fillColor('#2563EB').text('●', MG, y);\n doc.fillColor('#1F2937').text(text, MG + indent, y, { width: w, lineGap: 1 });\n y += h + 5;\n}\n```\n\n### Info Box (measures text height FIRST, then draws box)\n\n```javascript\nfunction infoBox(text, bg = '#FEF2F2', border = '#DC2626') {\n const pad = 12;\n const w = CW - pad * 2;\n doc.fontSize(9);\n \n // Calculate height FIRST\n const textH = doc.heightOfString(text, { width: w, lineGap: 1 });\n const boxH = textH + pad * 2;\n need(boxH + 10);\n \n // Then draw\n doc.fillColor(bg).rect(MG, y, CW, boxH).fill();\n doc.rect(MG, y, CW, boxH).strokeColor(border).lineWidth(1).stroke();\n doc.fillColor('#1F2937').text(text, MG + pad, y + pad, { width: w, lineGap: 1 });\n y += boxH + 12;\n}\n```\n\n### Data Table (auto row height calculation)\n\n```javascript\nfunction table(headers, rows, colW) {\n const pad = 6;\n const fs = 8;\n const hdrH = 24;\n \n doc.fontSize(fs);\n "},{"path":"references/sentiment-workflow.md","content":"# Sentiment Analysis Workflow\n\nComplete workflow for conducting sentiment analysis using the Verosight API.\n\n## Step 1: Authentication\n\n```bash\n# Set your API key\nexport VEROSIGHT_API_KEY=\"vlt_live_YOUR_KEY\"\n\n# Get JWT token (valid 24h)\nJWT=$(curl -s -X POST \"https://api.verosight.com/v1/auth/token\" \\\n -H \"X-API-Key: $VEROSIGHT_API_KEY\" | jq -r '.token')\n\n# Verify token works\ncurl -s \"https://api.verosight.com/v1/account/balance\" \\\n -H \"Authorization: Bearer $JWT\"\n```\n\n## Step 2: Get Sentiment Data\n\n```bash\ncurl -s \"https://api.verosight.com/v1/analytics/sentiment?query=KEYWORD&sources=x,instagram,tiktok&days=7\" \\\n -H \"Authorization: Bearer $JWT\" | jq .\n```\n\n### Response Fields\n\n| Field | Description |\n|-------|-------------|\n| `positive` / `negative` / `neutral` | Post counts by sentiment |\n| `positive_pct` / `negative_pct` / `neutral_pct` | Percentage breakdown |\n| `weighted_positive_pct` / `weighted_negative_pct` | Engagement-weighted percentages |\n| `sample_positive` / `sample_negative` | Sample posts with engagement data |\n| `sample_independent_negative` | Social media comments with negative sentiment |\n| `post_positive` / `post_negative` / `post_neutral` | Post-level sentiment counts |\n| `thread_positive` / `thread_negative` | Thread-level sentiment counts |\n| `independent_positive` / `independent_negative` | Independent comment sentiment |\n\n## Step 3: Get Volume Trend\n\n```bash\ncurl -s \"https://api.verosight.com/v1/analytics/volume?query=KEYWORD&days=7\" \\\n -H \"Authorization: Bearer $JWT\" | jq .\n```\n\nReturns daily breakdown of posts and comments by platform.\n\n## Step 4: Get High-Engagement Posts\n\n```bash\n# Negative posts from X\ncurl -s \"https://api.verosight.com/v1/posts?query=KEYWORD&sources=x&sentiment=negative&limit=15&days=7\" \\\n -H \"Authorization: Bearer $JWT\" | jq .\n\n# All posts from specific platforms\ncurl -s \"https://api.verosight.com/v1/posts?query=KEYWORD&sources=x,threads&limit=20&days=7\" \\\n -H \"Authorization: Bearer $JWT\" | jq .\n```\n\n## Step 5: Compile Report\n\nUse the following structure for your report:\n\n### Report Template\n\n```markdown\n# 🔍 SDV REPORT\n## Keyword: \"[KEYWORD]\"\n**Period:** [START] – [END] | **Sources:** [PLATFORMS]\n\n---\n\n## 📊 SENTIMENT OVERVIEW\n\n| Sentiment | Count | % | Weighted |\n|-----------|-------|---|----------|\n| Positive | X | X%| X% |\n| Negative | X | X%| X% |\n| Neutral | X | X%| X% |\n\n**Status:** [CRITICAL / HIGH / MEDIUM / LOW]\n\n## 📈 VOLUME TREND\n\n| Date | Posts | Change |\n|------|-------|--------|\n| Day 1| X | - |\n| Day 2| X | +X% |\n\n## 🔴 TOP NEGATIVE NARRATIVES\n\n1. **[Narrative title]** — @account (Platform, X likes, X shares)\n - Full quote or summary\n\n2. **[Narrative title]** — @account (Platform, X likes)\n - Full quote or summary\n\n## 🟢 TOP POSITIVE NARRATIVES\n\n1. **[Narrative title]** — @account (Platform, X likes)\n - Full quote or summary\n\n## 👤 VOCAL ACCOUNTS (Negative)\n\n| Account | Platform | Engagement | Narrative |\n|---------|----"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Integrate Verosight API for social media intelligence and cyber monitoring. Sentiment analysis, trend detection, influencer identification, and bot detection... Skill: Verosight Monitor Owner: jrrqd Summary: Integrate Verosight API for social media intelligence and cyber monitoring. Sentiment analysis, trend detection, influencer identification, and bot detection... Tags: latest:1.1.2 Version history: v1.1.2 | 2026-07-22T16:47:53.462Z | user Added MCP server support, 14+ platforms (Reddit, Darkweb, Capital Market), 30 MCP tools v1.1.1 | 2026-07-22T16:44:57.357Z | user Added","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1193,"uniquenessScore":46,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T06:51:12.695Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T06:51:12.695Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T09:08:55.010Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}