A professional-grade CLI integration for viral.app to manage social media analytics, creator hub resources, and automated payout workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install viral-app
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install viral-app using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is viral-app?
The viral-app skill empowers AI agents to interact directly with the viral.app API through a localized CLI. It provides a robust interface for fetching deep analytics across platforms like TikTok, Instagram, and YouTube, while also managing internal organizational resources like projects and creator campaigns. This skill is essential for teams looking to automate social media reporting and influencer management.
By leveraging Openclaw Skills, developers can integrate live platform data and KPI tracking into their automated workflows. The skill handles complex operations like calculating and initiating payouts with built-in integrity checks, ensuring that financial operations remain secure and accurate while providing rich, template-based reports for stakeholders.
viral-app Use Cases
- Automating weekly social media performance reports for TikTok and Instagram accounts.
- Managing creator hub resources including campaigns, projects, and payout calculations.
- Monitoring tracked video performance and identifying viral content trends through live data pulls.
- Synchronizing account analytics and KPI exports into external business intelligence tools.
- Streamlining influencer management by filtering creators and campaigns directly via CLI.
How viral-app Works
- The agent initializes the viral-app CLI using the configured environment variables for authentication.
- Commands are executed to query specific analytics or mutate resources such as projects or payouts.
- The skill automatically injects necessary API headers and handles request scoping using organization-specific IDs.
- For financial tasks, the skill follows a strict two-step verification process (calculate then initiate) to ensure data integrity.
- Results are returned as machine-readable JSON or rendered using specific Markdown templates for human-readable summaries.
viral-app Setup
First, ensure the viral-app CLI is installed in your system PATH. Then, configure your access token:
# Verify installation
viral-app --help
# Set your API key from the viral.app dashboard
export VIRAL_API_KEY="your_api_key_here"
# Test connectivity
viral-app accounts-list --per-page 1
viral-app Data Schema & Taxonomy
The skill organizes data around several core entities and utilizes specific metadata for filtering:
| Entity | Identifier Prefix | Description |
|---|---|---|
| Organization Account | orgacc_* |
Scoped social media account identifiers |
| Project | orgproj_* |
Internal project folders for grouping resources |
| Creator | orgcre_* |
Individual creator profiles in the Creator Hub |
| Campaign | orgcamp_* |
Specific marketing campaign containers |
It also utilizes time-bound parameters (--date-range[from]) and platform identifiers (facebook, tiktok, instagram, youtube) to structure its analytics queries.
viral-app Advanced Features
- Multi-platform support for live data extraction from major social networks.
- Built-in report templates for Slack-ready leaderboards and Viral Video Library summaries.
- Secure payout mutation flow with mandatory integrity token verification.
- Deep-linking capabilities to generate direct URLs to specific filtered views in the viral.app web UI.
- Configurable output formats and auto-pagination controls for scripted agent behavior.
SKILL.md
Loading
Related Openclaw Skills
SVG Generator
A local CLI tool for generating professional, customizable SVG backgrounds and vector graphics for websites and presentations.
Disk Analyzer (Duf)
A powerful disk usage and storage analysis tool designed to automate disk monitoring and file cleanup tasks.
Odoo
A module-aware operating workflow for Odoo ERP systems that ensures safe data management across CRM, sales, inventory, and accounting.
Content Monetizer
An AI-powered content analysis tool that evaluates your work to recommend the most profitable distribution platforms and monetization strategies.
Solana Blockchain Explorer & Portfolio Tracker
A lightweight Python-based tool to query Solana on-chain data and token portfolios with real-time USD pricing.
Stock Daily Report HK
An automated AI trading strategist that generates and delivers comprehensive Hong Kong stock market momentum reports to Feishu every trading day.
METADATA
Featured*
