Skip to content

docs(skills): use YouTube and Instagram source commands #22

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
DeanThompson merged 1 commit into from
Jun 28, 2026
Merged

docs(skills): use YouTube and Instagram source commands #22

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 18 additions & 18 deletions skills/apimux-instagram/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ metadata:
source: instagram
requires:
bins: ["apimux"]
cliHelp: "apimux schema capabilities | grep instagram"
cliHelp: "apimux instagram --help"
---

# Instagram
Expand All @@ -14,10 +14,10 @@ Search and inspect public Instagram users, hashtags, reels, profiles, posts, com

**Before using:** Read [`../apimux-shared/SKILL.md`](../apimux-shared/SKILL.md) for response structure, error handling, pagination metadata, and CLI conventions.

**CLI note:** Current `apimux-cli` does not expose `apimux instagram ...` source subcommands yet. Use the generic capability runner:
**CLI note:** Use the Instagram source subcommands for normal workflows:

```bash
apimux capability call instagram.search_reels --params-json '{"query":"desk setup","count":10}'
apimux instagram search_reels --query "desk setup" --count 10
```

## What you can do
Expand Down Expand Up @@ -70,8 +70,8 @@ Search public Instagram users by keyword.
### CLI usage

```bash
apimux capability call instagram.search_users --params-json '{"query":"desk setup","count":10}'
apimux capability call instagram.search_users --params-json '{"query":"desk setup","cursor":"<cursor>","count":10}'
apimux instagram search_users --query "desk setup" --count 10
apimux instagram search_users --query "desk setup" --cursor "<cursor>" --count 10
```

### Response fields
Expand Down Expand Up @@ -106,7 +106,7 @@ Search Instagram hashtags by keyword.
### CLI usage

```bash
apimux capability call instagram.search_hashtags --params-json '{"query":"desksetup"}'
apimux instagram search_hashtags --query "desksetup"
```

### Response fields
Expand Down Expand Up @@ -134,7 +134,7 @@ Search public Instagram reels by keyword.
### CLI usage

```bash
apimux capability call instagram.search_reels --params-json '{"query":"desk setup","count":10}'
apimux instagram search_reels --query "desk setup" --count 10
```

### Response fields
Expand Down Expand Up @@ -170,8 +170,8 @@ Fetch one public Instagram profile by username or user ID.
### CLI usage

```bash
apimux capability call instagram.get_user_profile --params-json '{"username":"natgeo"}'
apimux capability call instagram.get_user_profile --params-json '{"user_id":"123456789"}'
apimux instagram get_user_profile --username "natgeo"
apimux instagram get_user_profile --user-id "123456789"
```

### Notes
Expand All @@ -197,8 +197,8 @@ List public posts for one Instagram user.
### CLI usage

```bash
apimux capability call instagram.get_user_posts --params-json '{"username":"natgeo","count":12}'
apimux capability call instagram.get_user_posts --params-json '{"user_id":"123456789","count":12}'
apimux instagram get_user_posts --username "natgeo" --count 12
apimux instagram get_user_posts --user-id "123456789" --count 12
```

### Notes
Expand All @@ -224,7 +224,7 @@ List public reels for one Instagram user.
### CLI usage

```bash
apimux capability call instagram.get_user_reels --params-json '{"username":"natgeo","count":12}'
apimux instagram get_user_reels --username "natgeo" --count 12
```

### Notes
Expand All @@ -249,8 +249,8 @@ Fetch one public Instagram post or reel by shortcode, media ID, or URL.
### CLI usage

```bash
apimux capability call instagram.get_post_detail --params-json '{"shortcode":"C0abc123xyz"}'
apimux capability call instagram.get_post_detail --params-json '{"url":"https://www.instagram.com/p/C0abc123xyz/"}'
apimux instagram get_post_detail --shortcode "C0abc123xyz"
apimux instagram get_post_detail --url "https://www.instagram.com/p/C0abc123xyz/"
```

### Notes
Expand All @@ -277,8 +277,8 @@ List comments for one public Instagram post or reel.
### CLI usage

```bash
apimux capability call instagram.get_post_comments --params-json '{"shortcode":"C0abc123xyz","count":20}'
apimux capability call instagram.get_post_comments --params-json '{"url":"https://www.instagram.com/p/C0abc123xyz/","count":20}'
apimux instagram get_post_comments --shortcode "C0abc123xyz" --count 20
apimux instagram get_post_comments --url "https://www.instagram.com/p/C0abc123xyz/" --count 20
```

### Response fields
Expand Down Expand Up @@ -312,8 +312,8 @@ List replies for one Instagram parent comment.
### CLI usage

```bash
apimux capability call instagram.get_comment_replies --params-json '{"shortcode":"C0abc123xyz","comment_id":"18000000000000000","count":20}'
apimux capability call instagram.get_comment_replies --params-json '{"url":"https://www.instagram.com/p/C0abc123xyz/","comment_id":"18000000000000000","count":20}'
apimux instagram get_comment_replies --shortcode "C0abc123xyz" --comment-id "18000000000000000" --count 20
apimux instagram get_comment_replies --url "https://www.instagram.com/p/C0abc123xyz/" --comment-id "18000000000000000" --count 20
```

### Notes
Expand Down
34 changes: 17 additions & 17 deletions skills/apimux-youtube/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ metadata:
source: youtube
requires:
bins: ["apimux"]
cliHelp: "apimux schema capabilities | grep youtube"
cliHelp: "apimux youtube --help"
---

# YouTube
Expand All @@ -14,10 +14,10 @@ Search and inspect public YouTube videos, channels, transcripts, comments, and c

**Before using:** Read [`../apimux-shared/SKILL.md`](../apimux-shared/SKILL.md) for response structure, error handling, pagination metadata, and CLI conventions.

**CLI note:** Current `apimux-cli` does not expose `apimux youtube ...` source subcommands yet. Use the generic capability runner:
**CLI note:** Use the YouTube source subcommands for normal workflows:

```bash
apimux capability call youtube.search_videos --params-json '{"query":"standing desk","count":10}'
apimux youtube search_videos --query "standing desk" --count 10
```

## What you can do
Expand Down Expand Up @@ -66,8 +66,8 @@ Search public YouTube videos by query.
### CLI usage

```bash
apimux capability call youtube.search_videos --params-json '{"query":"desk setup","count":10}'
apimux capability call youtube.search_videos --params-json '{"query":"desk setup","cursor":"<cursor>","count":10}'
apimux youtube search_videos --query "desk setup" --count 10
apimux youtube search_videos --query "desk setup" --cursor "<cursor>" --count 10
```

### Response fields
Expand Down Expand Up @@ -102,8 +102,8 @@ Fetch one public YouTube video detail by `video_id` or URL.
### CLI usage

```bash
apimux capability call youtube.get_video_detail --params-json '{"video_id":"dQw4w9WgXcQ"}'
apimux capability call youtube.get_video_detail --params-json '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
apimux youtube get_video_detail --video-id "dQw4w9WgXcQ"
apimux youtube get_video_detail --url "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
```

### Notes
Expand All @@ -128,8 +128,8 @@ Fetch caption or transcript text for one public YouTube video.
### CLI usage

```bash
apimux capability call youtube.get_video_transcript --params-json '{"video_id":"dQw4w9WgXcQ","format":"plain"}'
apimux capability call youtube.get_video_transcript --params-json '{"video_id":"dQw4w9WgXcQ","language":"en","format":"segments"}'
apimux youtube get_video_transcript --video-id "dQw4w9WgXcQ" --format "plain"
apimux youtube get_video_transcript --video-id "dQw4w9WgXcQ" --language "en" --format "segments"
```

### Response fields
Expand Down Expand Up @@ -158,8 +158,8 @@ Fetch one YouTube channel summary by channel ID, handle, or URL.
### CLI usage

```bash
apimux capability call youtube.get_channel_detail --params-json '{"handle":"mkbhd"}'
apimux capability call youtube.get_channel_detail --params-json '{"url":"https://www.youtube.com/@mkbhd"}'
apimux youtube get_channel_detail --handle "mkbhd"
apimux youtube get_channel_detail --url "https://www.youtube.com/@mkbhd"
```

### Response fields
Expand Down Expand Up @@ -196,8 +196,8 @@ List videos or Shorts from one YouTube channel.
### CLI usage

```bash
apimux capability call youtube.get_channel_videos --params-json '{"handle":"mkbhd","content_type":"video","count":10}'
apimux capability call youtube.get_channel_videos --params-json '{"handle":"mkbhd","content_type":"shorts","count":10}'
apimux youtube get_channel_videos --handle "mkbhd" --content-type "video" --count 10
apimux youtube get_channel_videos --handle "mkbhd" --content-type "shorts" --count 10
```

### Response fields
Expand Down Expand Up @@ -230,8 +230,8 @@ List comments for one public YouTube video by `video_id` or URL.
### CLI usage

```bash
apimux capability call youtube.get_video_comments --params-json '{"video_id":"dQw4w9WgXcQ","count":20}'
apimux capability call youtube.get_video_comments --params-json '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","count":20}'
apimux youtube get_video_comments --video-id "dQw4w9WgXcQ" --count 20
apimux youtube get_video_comments --url "https://www.youtube.com/watch?v=dQw4w9WgXcQ" --count 20
```

### Response fields
Expand Down Expand Up @@ -263,8 +263,8 @@ List replies for one YouTube parent comment.
### CLI usage

```bash
apimux capability call youtube.get_comment_replies --params-json '{"comment_id":"Ug...","count":20}'
apimux capability call youtube.get_comment_replies --params-json '{"video_id":"dQw4w9WgXcQ","comment_id":"Ug...","count":20}'
apimux youtube get_comment_replies --comment-id "Ug..." --count 20
apimux youtube get_comment_replies --video-id "dQw4w9WgXcQ" --comment-id "Ug..." --count 20
```

### Notes
Expand Down
Loading