# Send Video Searching to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "video-searching",
    "name": "Video Searching",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/memories-ai-official/video-searching",
    "canonicalUrl": "https://clawhub.ai/memories-ai-official/video-searching",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/video-searching",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=video-searching",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "_meta.json",
      "run_video_query.sh",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/video-searching"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/video-searching",
    "downloadUrl": "https://openagent3.xyz/downloads/video-searching",
    "agentUrl": "https://openagent3.xyz/skills/video-searching/agent",
    "manifestUrl": "https://openagent3.xyz/skills/video-searching/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/video-searching/agent.md"
  }
}
```
## Documentation

### Video Searching Skill

Use this skill when the user asks to find, compare, or analyze social videos (YouTube, TikTok, Instagram, Twitter/X), or explicitly invokes /video_search.

This skill calls the Memories.ai Video Searching API — a managed, token-authenticated endpoint that searches across platforms and returns structured results via SSE.

### Triggering

Run this workflow when either condition is true:

Message starts with /video_search.
The user asks for video sourcing/trend/creator/brand analysis and wants concrete video links.

If /video_search is used with no query body, ask for the missing query.

### Execution contract

Resolve query text:

/video_search ... → strip /video_search and use remaining text.
Free-form → use user message as query.



Build the API request JSON body:

query (required): the user's search query
platforms (optional): array of youtube, tiktok, instagram, twitter — only set if user specifies platforms
max_results (optional, default 10): number of video results
time_frame (optional): past_24h, past_week, past_month, past_year — only set if user specifies recency
max_steps (optional, default 10): max agent iterations
enable_clarification (optional, default false): set to true if user query is vague



Call the runner script:
<skill_dir>/scripts/run_video_query.sh \\
  --query "<query>" \\
  [--platforms "youtube,tiktok"] \\
  [--max-results 10] \\
  [--time-frame past_week] \\
  [--enable-clarification]



Start with exec using background: true.


Poll with process using action: "poll" every 2–4 seconds until process exits.


Parse NDJSON output and render only these events:

started → send: 🔍 Starting video search...
progress → send concise progress update from message field (throttle: skip if last update was < 3s ago)
complete → send final formatted response (see below)
clarification → ask the clarification question directly; treat as final response
error → send concise failure reason with one actionable next step



Do not forward raw tool_call or tool_result events to the user.

### Final response format

When terminal event is complete:

One short paragraph conclusion (from answer field).
Top video references (up to 5 by default):

title
url
platform badge (e.g. 🎬 YouTube, 🎵 TikTok, 📸 Instagram, 🐦 X)
one-line relevance_note
key metrics: views, likes, engagement rate (if available)


Footer: ⏱ {execution_time_seconds}s · {steps_taken} steps · {tools_used}

If fewer videos exist, show all available references.

When terminal event is clarification:

Ask the clarification question directly.
Present options if provided.
Treat as final response for the current run.

When terminal event is error:

Send concise failure reason.
Include one actionable next step.

### Safety and fallback

If MEMORIES_API_KEY is not set, tell the user:

⚠️ Missing MEMORIES_API_KEY. Set it in your OpenClaw environment variables to use this skill.
Get your API key at https://api-tools.memories.ai


If the API returns a non-SSE error (HTTP 4xx/5xx), display the error message.
Never fabricate video URLs or metrics.
If the API is unreachable, suggest checking network connectivity and API status.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: memories-ai-official
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/video-searching)
- [Send to Agent page](https://openagent3.xyz/skills/video-searching/agent)
- [JSON manifest](https://openagent3.xyz/skills/video-searching/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/video-searching/agent.md)
- [Download page](https://openagent3.xyz/downloads/video-searching)