> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.yoinkit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Skill Commands

> All available yoinkit commands

## Overview

The `yoinkit` skill provides five main commands for social media research:

| Command      | Description                                        |
| ------------ | -------------------------------------------------- |
| `transcript` | Extract transcript from any video URL              |
| `content`    | Get full content and metadata from any social post |
| `search`     | Search for content on a specific platform          |
| `trending`   | Get currently trending content                     |
| `research`   | Compound command for automated research workflows  |

***

## transcript

Extract transcript/captions from video content.

### Syntax

```
yoinkit transcript <url>
```

### Supported Platforms

* YouTube videos
* TikTok videos
* Instagram Reels
* Facebook videos
* Twitch clips

### Examples

```bash theme={null}
yoinkit transcript https://youtube.com/watch?v=abc123
yoinkit transcript https://tiktok.com/@user/video/123
yoinkit transcript https://instagram.com/reel/xyz
```

### Output

Returns plain text transcript with optional speaker labels (when available).

***

## content

Get full content and metadata from any social post.

### Syntax

```
yoinkit content <url>
```

### Supported Platforms

All 14 platforms: YouTube, TikTok, Instagram, Twitter/X, Reddit, LinkedIn, Facebook, Twitch, Kick, Snapchat, Pinterest, Threads, Bluesky, Rumble

### Examples

```bash theme={null}
yoinkit content https://twitter.com/user/status/123
yoinkit content https://reddit.com/r/sub/comments/abc
yoinkit content https://linkedin.com/posts/user-activity-123
```

### Output

Returns structured data including:

* Post body/description
* Engagement metrics (likes, shares, comments)
* Author information
* Publish date
* Platform-specific metadata

***

## search

Search for content on a specific platform.

### Syntax

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

### Options

| Option    | Description                               |
| --------- | ----------------------------------------- |
| `--limit` | Number of results (default: 10)           |
| `--sort`  | Sort order: relevance, date, views        |
| `--time`  | Time filter: hour, day, week, month, year |

### Examples

```bash theme={null}
yoinkit search youtube "AI tools for creators"
yoinkit search tiktok "productivity tips" --limit 20
yoinkit search reddit "home automation" --subreddit technology --sort top
yoinkit search twitter "startup funding" --time week
```

### Output

Returns list of results with links, engagement metrics, and metadata.

***

## trending

Get currently trending content on a platform.

### Syntax

```
yoinkit trending <platform> [options]
```

### Options

| Option       | Description                     |
| ------------ | ------------------------------- |
| `--category` | Filter by category (YouTube)    |
| `--country`  | Country code (default: US)      |
| `--limit`    | Number of results (default: 20) |

### Examples

```bash theme={null}
yoinkit trending youtube --category tech
yoinkit trending tiktok --country US
yoinkit trending twitter
yoinkit trending reddit --subreddit technology
```

### Output

Returns ranked list of trending content with metrics.

***

## research

**Compound command** — Automated research workflow that combines multiple API calls.

### Syntax

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

### Options

| Option          | Description                                            |
| --------------- | ------------------------------------------------------ |
| `--platforms`   | Comma-separated list (default: youtube,tiktok,twitter) |
| `--depth`       | Research depth: quick, normal, deep                    |
| `--transcripts` | Pull transcripts from top videos (deep only)           |

### Examples

```bash theme={null}
yoinkit research "home automation"
yoinkit research "AI tools" --platforms youtube,tiktok,reddit --depth deep
yoinkit research "fitness trends" --depth quick
```

### What It Does

1. Searches each platform for the topic
2. Gets trending content in that space
3. (Deep mode) Pulls transcripts from top videos
4. Summarizes themes and angles
5. Identifies content opportunities

### Output

Returns a structured research report:

```markdown theme={null}
## Research Report: Home Automation

### Trending Topics
- Smart home security (YouTube, TikTok)
- Matter protocol updates (Reddit, Twitter)
- Budget automation setups (TikTok)

### Top Content This Week
1. "I Automated My Entire House for $500" (YouTube, 1.2M views)
   - Key angles: budget-friendly, DIY, beginner-focused

### Content Opportunities
- Gap: No recent content on "Matter + HomeKit integration"
- Trending format: "Day in my automated life" vlogs
```

***

## Platform Support

Not all platforms support all commands. Here's what works where:

| Platform     | Transcript | Content | Trending | Search |
| ------------ | :--------: | :-----: | :------: | :----: |
| YouTube      |      ✅     |    ✅    |     ✅    |    ✅   |
| TikTok       |      ✅     |    ✅    |     ✅    |    ✅   |
| Instagram    |  ✅ (reels) |    ✅    |     ✅    |    ✅   |
| Twitter/X    |      —     |    ✅    |     ✅    |    ✅   |
| Reddit       |      —     |    ✅    |     ✅    |    ✅   |
| LinkedIn     |      —     |    ✅    |     ✅    |    ✅   |
| Facebook     |      ✅     |    ✅    |     —    |    ✅   |
| Twitch       |      ✅     |    ✅    |     ✅    |    ✅   |
| Kick         |      ✅     |    ✅    |     ✅    |    ✅   |
| Snapchat     |      ✅     |    ✅    |     ✅    |    ✅   |
| Pinterest    |      —     |    ✅    |     ✅    |    ✅   |
| Threads      |      —     |    ✅    |     ✅    |    ✅   |
| Bluesky      |      —     |    ✅    |     ✅    |    ✅   |
| Truth Social |      —     |    ✅    |     ✅    |    ✅   |

<Note>
  **Transcripts** require video/audio content. Text-based platforms (Twitter, Reddit, LinkedIn) don't have transcripts — use `content` instead.
</Note>

<Note>
  **Trending by topic** isn't available on most platforms. Trending returns overall hot content. For topic-specific research, use `search` with time filters.
</Note>

***

## Natural Language

You don't have to use exact command syntax. Your AI assistant understands natural language:

<Tabs>
  <Tab title="Transcripts">
    > "Get the transcript from this YouTube video"

    > "What did they say in this TikTok?"

    > "Transcribe this Instagram reel for me"
  </Tab>

  <Tab title="Search by Topic">
    > "What's Twitter saying about the fourth amendment?"

    > "Find Reddit discussions about home automation from this week"

    > "Search for AI tool reviews on YouTube"
  </Tab>

  <Tab title="Trending">
    > "What's trending on TikTok right now?"

    > "Show me viral YouTube videos in tech"

    > "What's hot on Twitter today?"
  </Tab>

  <Tab title="Research">
    > "Research what creators are saying about productivity tools"

    > "Do deep research on the home automation niche"

    > "Find content opportunities in AI tools"
  </Tab>
</Tabs>

Your assistant translates your request into the appropriate API calls and handles platform limitations automatically.