Verosight Monitor — Social Media Intelligence Skill

Integrate Verosight API for real-time social media monitoring and digital reputation management across major platforms.

Quick Setup

1. Get API Key

Sign up at verosight.com and generate an API key from the API Keys dashboard. Keys start with vlt_live_ (production) or vlt_test_ (test).

2. Authenticate

Exchange your API key for a JWT token (valid 24 hours):

JWT=$(curl -s -X POST "https://api.verosight.com/v1/auth/token" \
  -H "X-API-Key: vlt_live_YOUR_KEY" | jq -r '.token')

Or use the bundled auth script:

./scripts/verosight-auth.sh vlt_live_YOUR_KEY

3. Query Data

# Sentiment analysis
curl -s "https://api.verosight.com/v1/analytics/sentiment?query=KEYWORD&sources=x,instagram&days=7" \
  -H "Authorization: Bearer $JWT"

# Search posts
curl -s "https://api.verosight.com/v1/posts?query=KEYWORD&sources=x,instagram&limit=10" \
  -H "Authorization: Bearer $JWT"

API Endpoints

Posts

GET /v1/posts

Search posts across platforms with filters.

GET /v1/posts/:id

Get a single post by ID.

GET /v1/posts/:id/comments

Get comments for a post.

Analytics

GET /v1/analytics/sentiment

Sentiment analysis for a keyword. Returns positive/negative/neutral breakdown, weighted percentages, and sample posts.

GET /v1/analytics/volume

Post/comment volume over time (daily breakdown).

GET /v1/analytics/trending

Trending posts and profiles for a keyword.

Profiles

GET /v1/profiles?query=ACCOUNT&source=instagram

Search for social media profiles.

GET /v1/profiles/:source/:account

Get profile details (auto-crawls if missing).

GET /v1/profiles/:source/:account/stats

Engagement stats for a profile.

Search

POST /v1/search

Semantic search across all content.

Body:

{
  "query": "keyword",
  "sources": ["x", "instagram"],
  "days": 7
}

Account

GET /v1/account/balance

Check credit balance (0 cost).

GET /v1/account/usage

Usage history and statistics (0 cost).

Response Format

All responses follow a standard envelope:

{
  "data": { ... },
  "meta": {
    "request_id": "uuid",
    "credits_used": 2,
    "credits_remaining": 998
  },
  "pagination": {
    "next_cursor": "base64...",
    "has_more": true,
    "total": 38113
  }
}

Workflows

Sentiment Analysis Report

1. Authenticate → get JWT
2. Query /v1/analytics/sentiment → get positive/negative/neutral breakdown
3. Query /v1/posts with sentiment=negative → identify vocal accounts
4. Query /v1/analytics/volume → trend over time
5. Compile report: overview → trend → narratives → insights → recommendations

For detailed workflow, see references/sentiment-workflow.md.

Influencer Identification

1. Query posts about target topic with high engagement
2. Sort by likes, shares, views
3. Cross-reference with sentiment (positive vs negative influencers)
4. Profile top accounts for follower count and verification status

Bot Detection

1. Query posts about target topic across platforms
2. Look for patterns:
   • Multiple posts from same account in short timeframe
   • Identical or near-identical content across accounts
   • Coordinated posting timing
   • New accounts with abnormally high activity
3. Flag suspicious accounts for manual review

PDF Report Generation

Generate professional reports with tables, charts, and formatted layouts using pdfkit (Node.js).

See references/pdf-template.md for complete guide.

Supported Platforms

Credit System

Each successful API call (2xx response) costs credits. Failed calls (4xx/5xx) do not deduct credits.

Check balance:

curl -s "https://api.verosight.com/v1/account/balance" \
  -H "Authorization: Bearer $JWT"

Known Limitations

• News portal results dominate volume (~70%); social platforms contribute less
• Semantic search returns broadly relevant results; source/date filters are limited
• Instagram direct scraping often blocked; use Verosight API for Instagram data
• Profile metadata (followers, account age) may not be available for all accounts

Bundled Resources

Links

• Verosight API
• API Dashboard
• Documentation
• ClawHub
• GitHub