Xpersona
agentCLAWHUBUnverified

ViralQuery

Set up and use ViralQuery's protected HTTP API to build a private video inspiration feed for one app, website, or niche. Use when an agent needs to help obta... Skill: ViralQuery Owner: tfcbot Summary: Set up and use ViralQuery's protected HTTP API to build a private video inspiration feed for one app, website, or niche. Use when an agent needs to help obta... Tags: latest:1.2.0 Version history: v1.2.0 | 2026-07-12T02:40:36.106Z | user Add API-key setup, configuration verification, and complete scroll workflow guidance; retain live ViralQuery docs as the canonical reference.

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

969

Updated

Oct 12, 2026

Version

1.2.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 969 downloads reported by the source. Last updated 10/12/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 12, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 12, 2026
Adoption signal
969 downloadsadoption · observed Oct 12, 2026
Latest release
1.2.0release · observed Jul 12, 2026
Handshake status
UNKNOWNsecurity

What changed

Newest first. Only changes that point at a source are listed.

  • Release 1.2.0release

    Add API-key setup, configuration verification, and complete scroll workflow guidance; retain live ViralQuery docs as the canonical reference.

    Observed Jul 12, 2026 · source

Install and run

Setup complexity: low.

clawhub skill install s17ee747e56qbmkcrwys763sys83gdzz:viralquery
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-tfcbot-viralquery/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

24,313 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: viralquery
description: Set up and use ViralQuery's protected HTTP API to build a private video inspiration feed for one app, website, or niche. Use when an agent needs to help obtain or configure a ViralQuery API key, verify authentication, create or update a research brief and rules, run and monitor a scroll, or retrieve tenant-scoped library, outlier, trend, and hook signals.
---

# ViralQuery

Use ViralQuery as the user's personal research feed. The bearer key fixes the tenant, and the
tenant's research brief scopes every scroll and result read.

Read [ViralQuery's LLM documentation](https://viralquery.com/llms.txt) before making an exact
request. It is the source of truth for current paths, fields, responses, and errors. Human-readable
setup guides live at [viralquery.com/docs](https://viralquery.com/docs).

## Set up access

1. Use `https://api.viralquery.com` unless a configured API URL overrides it.
2. Resolve credentials without printing them:
   - first use `VIRALQUERY_API_KEY` from the environment or agent secret store;
   - otherwise read `apiKey` and optional `apiUrl` from `~/.viralquery/config.json` when present.
3. If no key is configured, tell the user to open
   [viralquery.com/#pricing](https://viralquery.com/#pricing), choose a plan, finish checkout, and
   save the key shown once. Never ask the user to paste the key into chat.
4. Configure either of these supported forms:

   ```bash
   export VIRALQUERY_API_KEY=sk_viralquery_...
   npx viralquery auth --url https://api.viralquery.com --key "$VIRALQUERY_API_KEY"
   ```

   The CLI command writes `~/.viralquery/config.json`; API-based agents can use the environment
   secret directly.
5. Verify configuration with a protected `GET /v1/usage` request using
   `Authorization: Bearer <key>`. A `200` response means the configuration works. Treat `401` as a
   missing or invalid key and `402` as an inactive subscription. Do not use public `/health` to
   validate credentials.

## Run a scroll

1. Call `GET /v1/workspace`. If empty, call `POST /v1/workspace` with the user's research
   description and any exact App Store URL, website, competitor names, or display name they
   supplied. Never substitute another product.
2. Read `GET /v1/rules`. When the user provides standing guidance, save it with `PUT /v1/rules`.
3. Start one scroll with `POST /v1/scrolls`. Include the user's one-run `prompt` and a stable,
   unique `idempotencyKey`; use scheduling fields only when the user asks for recurring research.
4. Save the returned scroll ID. Poll `GET /v1/scrolls?id=SCROLL_ID` at a bounded interval until it
   completes or fails. If it remains queued or running, report the ID, status, and progress instead
   of claiming completion. Do not start overlapping work for the same workspace.
5. After completion, read only the result needed: `/v1/library`, `/v1/outliers`, `/v1/trends`, or
   `/v1/hooks`. Report insufficient history honestly and cite each original source URL used in the

_meta.json

{
  "ownerId": "kn748c4j0mce43k14xb4x94pxd819cxq",
  "slug": "viralquery",
  "version": "1.2.0",
  "publishedAt": 1783824036106
}

skill-card.md

## Description:

Set up and use ViralQuery's protected HTTP API to build a private video inspiration feed for one app, website, or niche.

This skill is ready for commercial/non-commercial use.

## Publisher:

[tfcbot](https://clawhub.ai/user/tfcbot)

### License/Terms of Use:

MIT-0

## Use Case:

External developers and agent operators use ViralQuery to configure tenant-scoped video research, verify API access, run a scroll, and retrieve library, outlier, trend, and hook signals for one app, website, or niche.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The setup flow includes an unpinned `npx viralquery` command that may handle a live API key.

Mitigation: Use an environment variable or secret store for the key and prefer a pinned or manually verified CLI setup path before running commands.

Risk: The skill treats mutable remote documentation as the source of truth for operational API details.

Mitigation: Treat remote documentation as reference material and constrain API actions to the intended ViralQuery tenant and workspace.

## Reference(s):

- [ViralQuery LLM Documentation](https://viralquery.com/llms.txt)
- [ViralQuery Documentation](https://viralquery.com/docs)
- [ClawHub Skill Page](https://clawhub.ai/tfcbot/skills/viralquery)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [Markdown with inline shell commands and API request guidance]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May include source URLs from retrieved ViralQuery results when reporting research findings.]

## Skill Version(s):

1.2.0 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

agents/openai.yaml

interface:
  display_name: "ViralQuery"
  short_description: "Set up and run private video research"
  default_prompt: "Use $viralquery to verify my API setup, configure my research brief and rules, run a scroll, and return the strongest source videos and signals."

Related agents

Same protocol, similar job.

Github ReposUpdated 3d agoRank 70

AionUi

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!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/tfcbot/skills/viralquery",
      "sourceUrl": "https://clawhub.ai/tfcbot/skills/viralquery",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-12T00:17:26.073Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-tfcbot-viralquery/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tfcbot-viralquery/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-12T00:17:26.073Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "969 downloads",
      "href": "https://clawhub.ai/tfcbot/viralquery",
      "sourceUrl": "https://clawhub.ai/tfcbot/viralquery",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-12T00:17:26.073Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.2.0",
      "href": "https://clawhub.ai/tfcbot/viralquery",
      "sourceUrl": "https://clawhub.ai/tfcbot/viralquery",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-07-12T02:40:36.106Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-tfcbot-viralquery/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tfcbot-viralquery/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.2.0",
      "description": "Add API-key setup, configuration verification, and complete scroll workflow guidance; retain live ViralQuery docs as the canonical reference.",
      "href": "https://clawhub.ai/tfcbot/viralquery",
      "sourceUrl": "https://clawhub.ai/tfcbot/viralquery",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-07-12T02:40:36.106Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 12, 2026.

For crawlers

This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.

  • One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
  • Every agent, one feed: /.well-known/ai-catalog.json
  • What this site sells, and the price: /.well-known/x402
  • Paid run-check: /api/v1/agents/clawhub-tfcbot-viralquery/run-check

Sponsored

Ads related to ViralQuery and adjacent AI workflows.