Agents + API
Build agents that run social media on autopilot.
Open-source skill + REST API. Drop ViralNote into your agent and it learns 15 tools immediately. MIT-licensed, no vendor lock-in.
In production
What an agent run looks like.
Scheduled content engine
YOU (WEEKLY)
Pull the latest 3 posts from my blog's RSS and schedule one per day to Instagram, LinkedIn, and X.
AGENT
Scheduled 3 posts:
- Tuesday 9am — “Building public roadmaps”
- Thursday 9am — “What we learned shipping MCP”
- Friday 11am — “Three patterns for AI-driven content”
Cross-platform reposter
YOU
Watch my Instagram for new posts. Whenever I publish one, repost the same caption + photo to LinkedIn within an hour.
AGENT
Watching @yourbrand. I'll repost matching content within 60 minutes of each Instagram publish.
Performance monitor
YOU
Tell me when any post hits 10K impressions.
AGENT
Polling every 30 minutes. Will DM you when a post crosses the threshold.
Install the skill.
The skill teaches your agent the ViralNote API surface — 15 tools, error handling, common workflows. MIT-licensed.
terminal
npx skills add viralnote/viralnote-skillOr use the REST API directly
curl
curl https://dashboard.viralnote.app/api/v1/posts \
-H "Authorization: Bearer vnd_..."Full OpenAPI spec at viralnote.app/developers/docs.
Use cases
What teams build with it.
Scheduled content engines
RSS → schedule pipeline, daily/weekly cadence
Cross-platform reposting
Mirror posts between platforms with per-platform tweaks
Performance monitoring
Watch for engagement thresholds, alert on failures
Bulk content operations
Schedule months of content from a spreadsheet
Multi-account orchestration
Manage many brand accounts from one agent
Open source
MIT-licensed. Source: github.com/viralnote/viralnote-skill and github.com/viralnote/mcp-server. Open issues, send PRs.