From bd536601fe543de904cd349e8fd0b81612bee973 Mon Sep 17 00:00:00 2001 From: Yangliang Li Date: Mon, 29 Jun 2026 01:07:05 +0800 Subject: [PATCH] docs(skills): use youtube and instagram source commands --- skills/apimux-instagram/SKILL.md | 36 ++++++++++++++++---------------- skills/apimux-youtube/SKILL.md | 34 +++++++++++++++--------------- 2 files changed, 35 insertions(+), 35 deletions(-) diff --git a/skills/apimux-instagram/SKILL.md b/skills/apimux-instagram/SKILL.md index b73d1c7..af1ae9a 100644 --- a/skills/apimux-instagram/SKILL.md +++ b/skills/apimux-instagram/SKILL.md @@ -5,7 +5,7 @@ metadata: source: instagram requires: bins: ["apimux"] - cliHelp: "apimux schema capabilities | grep instagram" + cliHelp: "apimux instagram --help" --- # Instagram @@ -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 @@ -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":"","count":10}' +apimux instagram search_users --query "desk setup" --count 10 +apimux instagram search_users --query "desk setup" --cursor "" --count 10 ``` ### Response fields @@ -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 @@ -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 @@ -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 @@ -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 @@ -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 @@ -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 @@ -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 @@ -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 diff --git a/skills/apimux-youtube/SKILL.md b/skills/apimux-youtube/SKILL.md index 7c7fc47..4c91fc8 100644 --- a/skills/apimux-youtube/SKILL.md +++ b/skills/apimux-youtube/SKILL.md @@ -5,7 +5,7 @@ metadata: source: youtube requires: bins: ["apimux"] - cliHelp: "apimux schema capabilities | grep youtube" + cliHelp: "apimux youtube --help" --- # YouTube @@ -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 @@ -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":"","count":10}' +apimux youtube search_videos --query "desk setup" --count 10 +apimux youtube search_videos --query "desk setup" --cursor "" --count 10 ``` ### Response fields @@ -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 @@ -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 @@ -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 @@ -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 @@ -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 @@ -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