# Send YoinkIt 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "yoinkit",
    "name": "YoinkIt",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/seomikewaltman/yoinkit",
    "canonicalUrl": "https://clawhub.ai/seomikewaltman/yoinkit",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/yoinkit",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yoinkit",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "examples/competitor-watch.json",
      "examples/creator-monitor.json",
      "examples/daily-trends.json",
      "examples/niche-monitor.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "yoinkit",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-11T08:22:20.653Z",
      "expiresAt": "2026-05-18T08:22:20.653Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yoinkit",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yoinkit",
        "contentDisposition": "attachment; filename=\"yoinkit-1.0.8.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "yoinkit"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/yoinkit"
    },
    "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/yoinkit",
    "downloadUrl": "https://openagent3.xyz/downloads/yoinkit",
    "agentUrl": "https://openagent3.xyz/skills/yoinkit/agent",
    "manifestUrl": "https://openagent3.xyz/skills/yoinkit/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/yoinkit/agent.md"
  }
}
```
## Documentation

### Yoinkit — OpenClaw Skill

Search, analyze, and transcribe content across 13 social platforms — trending topics, video transcripts, post metadata, creator feeds, and multi-platform research workflows.

### Platform Reference

Before running commands, check references/platforms.md for:

Which platforms support transcript/trending/search/user feed
Platform-specific parameters and options
How to handle unsupported operations

### Requirements

Yoinkit subscription with API access enabled
API Token from Yoinkit Settings → OpenClaw

### Configuration

Set your API token in OpenClaw config:

# Via chat command
/config set skills.entries.yoinkit.env.YOINKIT_API_TOKEN="your-token-here"

Or edit ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "yoinkit": {
        "env": {
          "YOINKIT_API_TOKEN": "your-token-here",
          "YOINKIT_API_URL": "https://yoinkit.ai/api/v1/openclaw"
        }
      }
    }
  }
}

Local testing: Set YOINKIT_API_URL to http://localhost:8000/api/v1/openclaw to test against a local server. Defaults to production if not set.

### yoinkit transcript <url> [options]

Extract transcript from video URL.

Supported: YouTube, TikTok, Instagram, Twitter/X, Facebook

Options:

--language CODE — 2-letter language code (YouTube, TikTok only). Example: en, es, fr

yoinkit transcript https://youtube.com/watch?v=abc123
yoinkit transcript https://youtube.com/watch?v=abc123 --language es
yoinkit transcript https://tiktok.com/@user/video/123
yoinkit transcript https://instagram.com/reel/abc123

### yoinkit content <url>

Get full content and metadata from a social post.

Supported: YouTube, TikTok, Instagram, Twitter/X, Facebook, LinkedIn, Reddit, Pinterest, Threads, Bluesky, Truth Social, Twitch, Kick

yoinkit content https://youtube.com/watch?v=abc123
yoinkit content https://twitter.com/user/status/123
yoinkit content https://reddit.com/r/technology/comments/abc
yoinkit content https://bsky.app/profile/user.bsky.social/post/abc

### yoinkit search <platform> "<query>" [options]

Search content on a platform. Each platform has different params — use the ones that apply.

Supported: YouTube, TikTok, Instagram, Reddit, Pinterest

Common options:

--sort TYPE — Sort results (platform-specific values, see below)
--time PERIOD — Filter by time (platform-specific values, see below)
--cursor TOKEN — Pagination cursor from previous response
--continuation TOKEN — YouTube pagination token
--page N — Page number (Instagram only)

Platform-specific sort values:

YouTube: relevance, popular
TikTok: relevance, most-liked, date-posted
Reddit: relevance, new, top, comment_count

Platform-specific time values:

YouTube: today, this_week, this_month, this_year
TikTok: yesterday, this-week, this-month, last-3-months, last-6-months, all-time
Reddit: all, day, week, month, year

yoinkit search youtube "AI tools for creators"
yoinkit search youtube "AI tools" --sort popular --time this_week
yoinkit search tiktok "productivity tips" --sort most-liked
yoinkit search reddit "home automation" --sort top --time month
yoinkit search instagram "fitness motivation" --page 2
yoinkit search pinterest "Italian recipes"

### yoinkit trending <platform> [options]

Get currently trending content.

Supported: YouTube, TikTok

Options:

--type TYPE — TikTok only: trending (default), popular, or hashtags
--country CODE — TikTok only: 2-letter country code (default: US)
--period DAYS — TikTok popular/hashtags: 7, 30, or 120
--page N — TikTok popular/hashtags: page number
--order TYPE — TikTok popular only: hot, like, comment, repost

Note: YouTube trending takes no parameters — it returns currently trending shorts.

yoinkit trending youtube
yoinkit trending tiktok
yoinkit trending tiktok --type popular --country US --period 7 --order like
yoinkit trending tiktok --type hashtags --period 30

### yoinkit feed <platform> <handle> [options]

Get a user's recent posts/videos.

Supported: YouTube, TikTok, Instagram, Twitter/X, Facebook, Threads, Bluesky, Truth Social

Options:

--type posts|reels|videos — Content type (Instagram, Facebook). Default: posts
--sort latest|popular — Sort order (YouTube only)
--cursor TOKEN — Pagination cursor

yoinkit feed youtube MrBeast
yoinkit feed youtube @mkbhd --sort latest
yoinkit feed tiktok garyvee
yoinkit feed instagram ali-abdaal --type reels
yoinkit feed twitter elonmusk
yoinkit feed threads zuck
yoinkit feed bluesky user.bsky.social

Note: Handles work with or without the @ prefix.

### yoinkit research "<topic>" [options]

Automated research workflow — combines search and trending across platforms.

Options:

--platforms LIST — Comma-separated platforms (default: youtube,tiktok)
--transcripts — Also fetch transcripts from top trending results

yoinkit research "home automation"
yoinkit research "AI tools" --platforms youtube,tiktok,reddit
yoinkit research "productivity" --transcripts

What it does:

Searches each platform for the topic
Gets trending content from supported platforms
Optionally fetches transcripts from top video results
Returns combined JSON results for analysis

### Natural Language

You don't need exact command syntax. The LLM will map natural requests to the right command:

"What's trending on TikTok?"
→ yoinkit trending tiktok

"Pull the transcript from this YouTube video: [url]"
→ yoinkit transcript <url>

"Find popular Reddit posts about home automation from this week"
→ yoinkit search reddit "home automation" --sort top --time week

"What has MrBeast posted this week?"
→ yoinkit feed youtube MrBeast

"Check @garyvee's latest TikToks"
→ yoinkit feed tiktok garyvee

"Research what creators are doing with AI tools"
→ yoinkit research "AI tools" --platforms youtube,tiktok,reddit

### API Base URL

All requests go through your Yoinkit subscription:

https://yoinkit.ai/api/v1/openclaw

### Output Formatting

A Yoinkit logo is included at assets/yoinkit-logo.png (200x200, transparent background, gradient icon).
When the platform supports images/media, send the logo alongside the first result in a conversation.

When presenting Yoinkit results to the user:

Prefix output with 🟣 Yoinkit as a header or label
Format video/post results as clean cards: title, views/engagement, date, link
Highlight key metadata (views, likes, publish date) — hide raw JSON noise
For transcript results, provide a concise summary first, then offer the full transcript if asked
For trending results, present as a numbered list with platform and engagement stats
For research results, organize by platform with clear section headers
Include a subtle footer: Powered by Yoinkit · yoinkit.ai
When results are empty or a platform isn't supported, suggest alternatives naturally

### Support

Issues: https://github.com/seomikewaltman/yoinkit-openclaw-skill/issues
Yoinkit: https://yoinkit.ai
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: seomikewaltman
- Version: 1.0.8
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-11T08:22:20.653Z
- Expires at: 2026-05-18T08:22:20.653Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/yoinkit)
- [Send to Agent page](https://openagent3.xyz/skills/yoinkit/agent)
- [JSON manifest](https://openagent3.xyz/skills/yoinkit/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/yoinkit/agent.md)
- [Download page](https://openagent3.xyz/downloads/yoinkit)