yuanflow-cli 0.1.5 → 0.1.6

package/src/cli.js

@@ -17,6 +17,12 @@ import {
 } from './agent-protocol.js';
 import { findShortcut, listShortcuts } from './shortcuts.js';
 import { collectComments } from './comment-collector.js';
+import {
+  getWorkDetail,
+  getWorkDownload,
+  searchContent,
+  searchUsers,
+} from './work-tools.js';
 
 export async function main(argv) {
   const args = argv.slice(2);
@@ -52,6 +58,16 @@ export async function main(argv) {
     return;
   }
 
+  if (command === 'works') {
+    await handleWorks(rest);
+    return;
+  }
+
+  if (command === 'search') {
+    await handleSearch(rest);
+    return;
+  }
+
   if (command === 'schema') {
     await handleSchema(rest);
     return;
@@ -243,6 +259,72 @@ async function handleComments(args) {
   });
 }
 
+async function handleWorks(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'detail'] = positionals;
+  const platform = options.named?.platform;
+  const target = options.named?.target || positionals[1];
+  if (!platform) {
+    throw new Error('缺少 --platform，例如 douyin、youtube、bilibili。');
+  }
+  if (!target) {
+    throw new Error('缺少 --target 或目标位置参数。');
+  }
+
+  let result;
+  if (action === 'detail') {
+    result = await getWorkDetail({
+      platform,
+      target,
+      prefer: options.named?.prefer || 'primary',
+      kind: options.named?.kind,
+      targetKind: options.named?.['target-kind'],
+      options,
+    });
+  } else if (action === 'download') {
+    result = await getWorkDownload({
+      platform,
+      target,
+      prefer: options.named?.prefer || 'primary',
+      kind: options.named?.kind,
+      targetKind: options.named?.['target-kind'],
+      options,
+    });
+  } else {
+    throw new Error('未知 works 命令。用法：yuanflow-cli works detail|download --platform douyin --target <作品链接或ID>');
+  }
+  await outputResult(result, options, {
+    command: `works ${action}`,
+    meta: { endpoint: result.endpoint.path, kind: result.endpoint.kind || `work-${action}` },
+  });
+}
+
+async function handleSearch(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'content'] = positionals;
+  const platform = options.named?.platform;
+  const keyword = options.named?.keyword || positionals[1];
+  if (!platform) {
+    throw new Error('缺少 --platform，例如 douyin、xiaohongshu、instagram。');
+  }
+  if (!keyword) {
+    throw new Error('缺少 --keyword 或关键词位置参数。');
+  }
+
+  let result;
+  if (action === 'content') {
+    result = await searchContent({ platform, keyword, options });
+  } else if (action === 'users' || action === 'user') {
+    result = await searchUsers({ platform, keyword, options });
+  } else {
+    throw new Error('未知 search 命令。用法：yuanflow-cli search content|users --platform douyin --keyword <关键词>');
+  }
+  await outputResult(result, options, {
+    command: `search ${action}`,
+    meta: { endpoint: result.endpoint.path, kind: result.endpoint.kind || `${action}-search` },
+  });
+}
+
 async function handleGeneratedCommand(platform, args) {
   if (!getPlatforms().includes(platform)) {
     throw new Error(`未知平台：${platform}。可用平台：${getPlatforms().join(', ')}`);
@@ -397,6 +479,10 @@ function printHelp() {
   yuanflow-cli commands list
   yuanflow-cli schema douyin.video-detail
   yuanflow-cli comments collect --platform douyin --target "https://v.douyin.com/xxx/" --dry-run
+  yuanflow-cli works detail --platform douyin --target "https://v.douyin.com/xxx/" --dry-run
+  yuanflow-cli works download --platform youtube --target "dQw4w9WgXcQ" --dry-run
+  yuanflow-cli search content --platform xiaohongshu --keyword "美妆" --dry-run
+  yuanflow-cli search users --platform instagram --keyword "nasa" --dry-run
   yuanflow-cli list douyin
 
 说明：

package/src/work-tool-definitions.js

@@ -0,0 +1,569 @@
+export const DETAIL_ENDPOINTS = {
+  douyin: [
+    {
+      method: 'GET',
+      path: '/douyin/web/fetch_one_video_by_share_url',
+      targetParam: 'share_url',
+      targetMode: 'raw-url',
+      description: '抖音作品详情，优先使用分享链接。',
+    },
+    {
+      method: 'GET',
+      path: '/douyin/web/fetch_one_video',
+      targetParam: 'aweme_id',
+      targetMode: 'id',
+      description: '抖音作品详情，使用 aweme_id。',
+    },
+    {
+      method: 'GET',
+      path: '/douyin/app/v3/fetch_one_video_by_share_url',
+      targetParam: 'share_url',
+      targetMode: 'raw-url',
+      prefer: 'fallback',
+      description: '抖音作品详情备用 app v3 接口。',
+    },
+  ],
+  xiaohongshu: [
+    {
+      method: 'GET',
+      path: '/xiaohongshu/web_v3/fetch_note_detail',
+      targetParam: 'note_id',
+      targetMode: 'id',
+      optionParams: { 'xsec-token': 'xsec_token' },
+      description: '小红书笔记详情。',
+    },
+  ],
+  bilibili: [
+    {
+      method: 'GET',
+      path: '/bilibili/web/fetch_one_video_v3',
+      targetParam: 'url',
+      targetMode: 'raw-url',
+      description: 'B站视频详情，优先使用视频 URL。',
+    },
+    {
+      method: 'GET',
+      path: '/bilibili/web/fetch_one_video',
+      targetParam: 'bv_id',
+      targetMode: 'id',
+      description: 'B站视频详情，使用 BV 号。',
+    },
+  ],
+  wechat_channels: [
+    {
+      method: 'GET',
+      path: '/wechat_channels/fetch_video_detail',
+      targetParam: 'id',
+      targetMode: 'id',
+      optionParams: { 'export-id': 'exportId' },
+      description: '微信视频号视频详情。',
+    },
+  ],
+  wechat_mp: [
+    {
+      method: 'GET',
+      path: '/wechat_mp/web/fetch_mp_article_detail_json',
+      targetParam: 'url',
+      targetMode: 'raw',
+      description: '微信公众号文章详情 JSON。',
+    },
+  ],
+  tiktok: [
+    {
+      method: 'GET',
+      path: '/tiktok/app/v3/fetch_one_video_by_share_url',
+      targetParam: 'share_url',
+      targetMode: 'raw-url',
+      description: 'TikTok 作品详情，优先使用分享链接。',
+    },
+    {
+      method: 'GET',
+      path: '/tiktok/web/fetch_post_detail',
+      targetParam: 'itemId',
+      targetMode: 'id',
+      description: 'TikTok 作品详情，使用 itemId。',
+    },
+  ],
+  instagram: [
+    {
+      method: 'GET',
+      path: '/instagram/v1/fetch_post_by_url',
+      targetParam: 'post_url',
+      targetMode: 'raw-url',
+      description: 'Instagram 帖子详情，使用帖子 URL。',
+    },
+    {
+      method: 'GET',
+      path: '/instagram/v3/get_post_info_by_code',
+      targetParam: 'code',
+      targetMode: 'id',
+      targetKind: 'code',
+      description: 'Instagram 帖子详情，使用 shortcode。',
+    },
+    {
+      method: 'GET',
+      path: '/instagram/v3/get_post_info',
+      targetParam: 'media_id',
+      targetMode: 'id',
+      description: 'Instagram 帖子详情，使用 media_id。',
+    },
+  ],
+  kuaishou: [
+    {
+      method: 'GET',
+      path: '/kuaishou/web/fetch_one_video_by_url',
+      targetParam: 'url',
+      targetMode: 'raw-url',
+      description: '快手作品详情，使用作品链接。',
+    },
+    {
+      method: 'GET',
+      path: '/kuaishou/web/fetch_one_video_v2',
+      targetParam: 'photo_id',
+      targetMode: 'id',
+      description: '快手作品详情，使用 photo_id。',
+    },
+  ],
+  reddit: [
+    {
+      method: 'GET',
+      path: '/reddit/app/fetch_post_details',
+      targetParam: 'post_id',
+      targetMode: 'id',
+      optionParams: { 'comment-id': 'comment_id' },
+      defaults: { need_format: 'true' },
+      description: 'Reddit 帖子详情。',
+    },
+  ],
+  twitter: [
+    {
+      method: 'GET',
+      path: '/twitter/web/fetch_tweet_detail',
+      targetParam: 'tweet_id',
+      targetMode: 'id',
+      description: 'Twitter/X 推文详情。',
+    },
+  ],
+  weibo: [
+    {
+      method: 'GET',
+      path: '/weibo/web_v2/fetch_post_detail',
+      targetParam: 'id',
+      targetMode: 'id',
+      optionParams: { 'long-text': 'is_get_long_text' },
+      description: '微博作品详情。',
+    },
+    {
+      method: 'GET',
+      path: '/weibo/web/fetch_post_detail',
+      targetParam: 'post_id',
+      targetMode: 'id',
+      prefer: 'fallback',
+      description: '微博作品详情备用接口。',
+    },
+  ],
+  youtube: [
+    {
+      method: 'GET',
+      path: '/youtube/web_v2/get_video_info',
+      targetParam: 'video_id',
+      targetMode: 'id',
+      kind: 'video',
+      optionParams: { 'language-code': 'language_code', 'need-format': 'need_format' },
+      description: 'YouTube 视频详情。',
+    },
+    {
+      method: 'GET',
+      path: '/youtube/web_v2/get_post_detail',
+      targetParam: 'post_id',
+      targetMode: 'id',
+      kind: 'post',
+      optionParams: {
+        'language-code': 'language_code',
+        'country-code': 'country_code',
+        'need-format': 'need_format',
+      },
+      description: 'YouTube 社区帖子详情。',
+    },
+  ],
+  zhihu: [
+    {
+      method: 'GET',
+      path: '/zhihu/web/fetch_column_article_detail',
+      targetParam: 'article_id',
+      targetMode: 'id',
+      kind: 'article',
+      description: '知乎专栏文章详情。',
+    },
+    {
+      method: 'GET',
+      path: '/zhihu/web/fetch_question_answers',
+      targetParam: 'question_id',
+      targetMode: 'id',
+      kind: 'question',
+      optionParams: { cursor: 'cursor', limit: 'limit', offset: 'offset', order: 'order' },
+      description: '知乎问题回答列表，可作为问题详情和回答入口。',
+    },
+  ],
+  xigua: [
+    {
+      method: 'GET',
+      path: '/xigua/app/v2/fetch_one_video',
+      targetParam: 'item_id',
+      targetMode: 'id',
+      description: '西瓜视频作品详情。',
+    },
+  ],
+};
+
+export const DOWNLOAD_ENDPOINTS = {
+  douyin: [
+    {
+      method: 'GET',
+      path: '/douyin/app/v3/fetch_video_high_quality_play_url',
+      targetParam: 'share_url',
+      targetMode: 'raw-url',
+      optionParams: { region: 'region' },
+      description: '抖音视频最高画质播放/下载地址查询，优先使用分享链接。',
+    },
+    {
+      method: 'GET',
+      path: '/douyin/app/v3/fetch_video_high_quality_play_url',
+      targetParam: 'aweme_id',
+      targetMode: 'id',
+      optionParams: { region: 'region' },
+      description: '抖音视频最高画质播放/下载地址查询，使用 aweme_id。',
+    },
+    {
+      method: 'GET',
+      path: '/douyin/web/fetch_video_high_quality_play_url',
+      targetParam: 'share_url',
+      targetMode: 'raw-url',
+      optionParams: { region: 'region' },
+      prefer: 'fallback',
+      description: '抖音视频播放/下载地址备用 web 接口。',
+    },
+  ],
+  bilibili: [
+    {
+      method: 'GET',
+      path: '/bilibili/web/fetch_video_play_info',
+      targetParam: 'url',
+      targetMode: 'raw-url',
+      description: 'B站视频播放信息，使用视频 URL。',
+    },
+    {
+      method: 'GET',
+      path: '/bilibili/web/fetch_video_playurl',
+      targetParam: 'bv_id',
+      targetMode: 'id',
+      requiredOptions: ['cid'],
+      optionParams: { cid: 'cid' },
+      description: 'B站视频流地址，使用 BV 号和 cid。',
+    },
+  ],
+  youtube: [
+    {
+      method: 'GET',
+      path: '/youtube/web_v2/get_video_streams',
+      targetParam: 'video_id',
+      targetMode: 'id',
+      description: 'YouTube 视频流信息。',
+    },
+    {
+      method: 'GET',
+      path: '/youtube/web_v2/get_video_streams',
+      targetParam: 'video_url',
+      targetMode: 'raw-url',
+      description: 'YouTube 视频流信息，使用视频 URL。',
+    },
+    {
+      method: 'GET',
+      path: '/youtube/web_v2/get_signed_stream_url',
+      targetParam: 'video_id',
+      targetMode: 'id',
+      requiredOptions: ['itag'],
+      optionParams: { itag: 'itag' },
+      prefer: 'signed',
+      description: 'YouTube 已签名视频流 URL，需要 itag。',
+    },
+  ],
+  xigua: [
+    {
+      method: 'GET',
+      path: '/xigua/app/v2/fetch_one_video_play_url',
+      targetParam: 'item_id',
+      targetMode: 'id',
+      description: '西瓜视频播放链接。',
+    },
+  ],
+};
+
+export const CONTENT_SEARCH_ENDPOINTS = {
+  bilibili: {
+    method: 'GET',
+    path: '/bilibili/web/fetch_general_search',
+    keywordParam: 'keyword',
+    defaults: { order: 'totalrank', page: '1', page_size: '20' },
+    optionParams: {
+      order: 'order',
+      page: 'page',
+      'page-size': 'page_size',
+      duration: 'duration',
+      'pubtime-begin': 'pubtime_begin_s',
+      'pubtime-end': 'pubtime_end_s',
+    },
+    description: 'B站综合搜索。',
+  },
+  douyin: {
+    method: 'POST',
+    path: '/douyin/search/fetch_general_search_v2',
+    keywordParam: 'keyword',
+    bodyMode: true,
+    defaults: {
+      cursor: 0,
+      sort_type: '0',
+      publish_time: '0',
+      filter_duration: '0',
+      content_type: '0',
+      search_id: '',
+      backtrace: '',
+    },
+    optionParams: {
+      cursor: 'cursor',
+      sort: 'sort_type',
+      'sort-type': 'sort_type',
+      'publish-time': 'publish_time',
+      duration: 'filter_duration',
+      'filter-duration': 'filter_duration',
+      'content-type': 'content_type',
+      type: 'content_type',
+      'search-id': 'search_id',
+      backtrace: 'backtrace',
+    },
+    description: '抖音综合搜索 V2。',
+  },
+  xiaohongshu: {
+    method: 'GET',
+    path: '/xiaohongshu/web_v3/fetch_search_notes',
+    keywordParam: 'keyword',
+    optionParams: { page: 'page', sort: 'sort', type: 'note_type', 'note-type': 'note_type' },
+    description: '小红书笔记搜索。',
+  },
+  wechat_channels: {
+    method: 'GET',
+    path: '/wechat_channels/fetch_search_ordinary',
+    keywordParam: 'keywords',
+    description: '微信视频号综合搜索。',
+  },
+  tiktok: {
+    method: 'GET',
+    path: '/tiktok/app/v3/fetch_general_search_result',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'offset',
+      offset: 'offset',
+      count: 'count',
+      sort: 'sort_type',
+      'sort-type': 'sort_type',
+      'publish-time': 'publish_time',
+    },
+    description: 'TikTok 综合搜索。',
+  },
+  instagram: {
+    method: 'GET',
+    path: '/instagram/v3/general_search',
+    keywordParam: 'query',
+    optionParams: {
+      cursor: 'next_max_id',
+      'next-max-id': 'next_max_id',
+      'rank-token': 'rank_token',
+      metadata: 'enable_metadata',
+    },
+    description: 'Instagram 综合搜索。',
+  },
+  kuaishou: {
+    method: 'GET',
+    path: '/kuaishou/app/search_comprehensive',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'pcursor',
+      pcursor: 'pcursor',
+      sort: 'sort_type',
+      'sort-type': 'sort_type',
+      'publish-time': 'publish_time',
+      duration: 'duration',
+      scope: 'search_scope',
+    },
+    description: '快手综合搜索。',
+  },
+  reddit: {
+    method: 'GET',
+    path: '/reddit/app/fetch_dynamic_search',
+    keywordParam: 'query',
+    defaults: { search_type: 'post' },
+    optionParams: {
+      type: 'search_type',
+      'search-type': 'search_type',
+      sort: 'sort',
+      cursor: 'after',
+      after: 'after',
+      'time-range': 'time_range',
+      'safe-search': 'safe_search',
+      'allow-nsfw': 'allow_nsfw',
+      'need-format': 'need_format',
+    },
+    description: 'Reddit 动态搜索，默认搜索帖子。',
+  },
+  twitter: {
+    method: 'GET',
+    path: '/twitter/web/fetch_search_timeline',
+    keywordParam: 'keyword',
+    optionParams: { type: 'search_type', 'search-type': 'search_type', cursor: 'cursor' },
+    description: 'Twitter/X 搜索时间线。',
+  },
+  weibo: {
+    method: 'GET',
+    path: '/weibo/web_v2/fetch_advanced_search',
+    keywordParam: 'q',
+    optionParams: {
+      page: 'page',
+      type: 'search_type',
+      'search-type': 'search_type',
+      'include-type': 'include_type',
+      timescope: 'timescope',
+    },
+    description: '微博高级搜索。',
+  },
+  youtube: {
+    method: 'GET',
+    path: '/youtube/web_v2/get_general_search_v2',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'continuation_token',
+      'continuation-token': 'continuation_token',
+      'upload-date': 'upload_date',
+      type: 'type',
+      duration: 'duration',
+      features: 'features',
+      sort: 'sort_by',
+      'sort-by': 'sort_by',
+    },
+    description: 'YouTube 综合搜索。',
+  },
+  zhihu: {
+    method: 'GET',
+    path: '/zhihu/web/fetch_article_search_v3',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'offset',
+      offset: 'offset',
+      count: 'limit',
+      limit: 'limit',
+      sort: 'sort',
+      vertical: 'vertical',
+      'time-interval': 'time_interval',
+    },
+    description: '知乎文章搜索。',
+  },
+  xigua: {
+    method: 'GET',
+    path: '/xigua/app/v2/search_video',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'offset',
+      offset: 'offset',
+      sort: 'order_type',
+      'order-type': 'order_type',
+      'min-duration': 'min_duration',
+      'max-duration': 'max_duration',
+    },
+    description: '西瓜视频搜索。',
+  },
+};
+
+export const USER_SEARCH_ENDPOINTS = {
+  douyin: {
+    method: 'POST',
+    path: '/douyin/search/fetch_user_search_v2',
+    keywordParam: 'keyword',
+    bodyMode: true,
+    defaults: { cursor: 0 },
+    optionParams: { cursor: 'cursor' },
+    description: '抖音用户搜索 V2。',
+  },
+  xiaohongshu: {
+    method: 'GET',
+    path: '/xiaohongshu/web_v3/fetch_search_users',
+    keywordParam: 'keyword',
+    optionParams: { page: 'page' },
+    description: '小红书用户搜索。',
+  },
+  wechat_channels: {
+    method: 'GET',
+    path: '/wechat_channels/fetch_user_search',
+    keywordParam: 'keywords',
+    optionParams: { page: 'page' },
+    description: '微信视频号用户搜索。',
+  },
+  tiktok: {
+    method: 'GET',
+    path: '/tiktok/app/v3/fetch_user_search_result',
+    keywordParam: 'keyword',
+    optionParams: {
+      cursor: 'offset',
+      offset: 'offset',
+      count: 'count',
+      'follower-count': 'user_search_follower_count',
+      'profile-type': 'user_search_profile_type',
+      'other-pref': 'user_search_other_pref',
+    },
+    description: 'TikTok 用户搜索。',
+  },
+  instagram: {
+    method: 'GET',
+    path: '/instagram/v3/search_users',
+    keywordParam: 'query',
+    optionParams: { 'rank-token': 'rank_token' },
+    description: 'Instagram 用户搜索。',
+  },
+  kuaishou: {
+    method: 'GET',
+    path: '/kuaishou/app/search_user_v2',
+    keywordParam: 'keyword',
+    optionParams: { page: 'page' },
+    description: '快手用户搜索。',
+  },
+  weibo: {
+    method: 'GET',
+    path: '/weibo/web_v2/fetch_user_search',
+    keywordParam: 'query',
+    optionParams: {
+      page: 'page',
+      region: 'region',
+      auth: 'auth',
+      gender: 'gender',
+      age: 'age',
+      nickname: 'nickname',
+      tag: 'tag',
+      school: 'school',
+      work: 'work',
+    },
+    description: '微博用户搜索。',
+  },
+  youtube: {
+    method: 'GET',
+    path: '/youtube/web_v2/search_channels',
+    keywordParam: 'keyword',
+    optionParams: { cursor: 'continuation_token', 'continuation-token': 'continuation_token', 'need-format': 'need_format' },
+    description: 'YouTube 频道搜索。',
+  },
+  zhihu: {
+    method: 'GET',
+    path: '/zhihu/web/fetch_user_search_v3',
+    keywordParam: 'keyword',
+    optionParams: { cursor: 'offset', offset: 'offset', count: 'limit', limit: 'limit' },
+    description: '知乎用户搜索。',
+  },
+};
+