@tikomni/skills 1.0.5 → 1.0.7

package/README.md

@@ -67,7 +67,7 @@ The npm package currently exposes:
 
 | Skill | Role |
 | --- | --- |
-| `social-media-crawl` | Cross-platform structured crawling, fixed pipelines, fact-card persistence, and MCP-first generic retrieval |
+| `social-media-crawl` | TikOmni API-only social-media retrieval, fixed pipelines, ASR support, and fact-card persistence |
 
 ## 30-Second Quick Start
 
@@ -214,8 +214,8 @@ Once configured, you can trigger tasks in natural language, for example:
 - "Extract the structured fields and primary text from this Douyin video."
 - "Fetch this Xiaohongshu note and write a fact card."
 - "Collect works from this creator home and persist them into the author archive."
-- "Use TikOmni MCP to fetch a comment thread and return normalized JSON."
-- "Use TikOmni MCP to fetch search or ranking results and keep the output structured."
+- "Fetch a comment thread through TikOmni API and return normalized JSON."
+- "Fetch search or ranking results through TikOmni API and keep the output structured."
 
 ## Versioning and Releases
 

package/README.zh-CN.md

@@ -67,7 +67,7 @@
 
 | Skill | 作用 |
 | --- | --- |
-| `social-media-crawl` | 跨平台结构化抓取、固定 pipeline、事实卡入库、MCP-first 通用调用 |
+| `social-media-crawl` | TikOmni API-only 社媒数据获取、固定 pipeline、ASR 支持和事实卡入库 |
 
 ## 30 秒快速开始
 
@@ -214,8 +214,8 @@ TIKOMNI_CARD_ROOT="/absolute/path/to/tikomni-cards"
 - “提取这个抖音视频的结构化字段和主文本。”
 - “抓取这个小红书作品并写入事实卡。”
 - “抓取这个主页的作品并持续入库到作者目录。”
-- “通过 TikOmni MCP 获取这个评论线程并输出标准 JSON。”
-- “通过 TikOmni MCP 获取搜索或榜单结果，并保持结构化返回。”
+- “通过 TikOmni API 获取这个评论线程并输出标准 JSON。”
+- “通过 TikOmni API 获取搜索或榜单结果，并保持结构化返回。”
 
 ## 版本与发布
 

package/env.example

@@ -52,8 +52,8 @@ TIKOMNI_TIMEOUT_RETRY_MAX="3"
 # [EN] Base backoff for timeout retries in milliseconds. Default: 300
 TIKOMNI_TIMEOUT_RETRY_BACKOFF_MS="300"
 
-# [ZH] 自定义 HTTP User-Agent。默认值：内置浏览器样式 UA。通常不需要修改。
-# [EN] Custom HTTP User-Agent. Default: built-in browser-like UA. Usually no need to change.
+# [ZH] 自定义 HTTP User-Agent。默认值：内置标准 HTTP UA。通常不需要修改。
+# [EN] Custom HTTP User-Agent. Default: built-in standard HTTP UA. Usually no need to change.
 # TIKOMNI_HTTP_USER_AGENT="Mozilla/5.0 ..."
 
 # [ZH] 自定义 Accept-Language 请求头。默认值：zh-CN,zh;q=0.9,en;q=0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tikomni/skills",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "TikOmni skill installer CLI for structured social media crawling in Codex, Claude Code, and OpenClaw",
   "license": "MIT",
   "homepage": "https://github.com/mark-ly-wang/TikOmni-Skills#readme",
@@ -27,7 +27,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "test": "node --test",
+    "test": "node --test && python3 -m unittest discover -s skills/social-media-crawl/tests -p 'test_*.py'",
     "pack:dry-run": "npm pack --dry-run"
   },
   "publishConfig": {

package/skills/social-media-crawl/SKILL.md

@@ -1,45 +1,49 @@
 ---
 name: social-media-crawl
-description: Use this skill when the user asks about social media links, posts, creator homepages, comments, search results, rankings, livestreams, products, or wants to crawl / collect / fetch / retrieve / scrape social-media data; also trigger on 抓取 / 采集 / 获取 / 主页 / 评论 / 搜索 / 榜单 / 直播 / 商品 / 社交媒体.
+description: Use this skill when the user asks to fetch social-media data through TikOmni API, including links, posts, creator homepages, comments, search results, rankings, livestreams, products, subtitles, transcripts, or structured fields; also trigger on 抓取 / 采集 / 获取 / 主页 / 评论 / 搜索 / 榜单 / 直播 / 商品 / 社交媒体.
 ---
 
 # Social Media Crawl
 
 ## When To Use
 
-- Use this skill when the user needs any social-media object such as a work link, post, thread, long-form post, creator homepage, comment section, search result, ranking page, livestream room, or product page.
+- Use this skill when the user needs TikOmni API data for a social-media object such as a work link, post, thread, long-form post, creator homepage, comment section, search result, ranking page, livestream room, or product page.
 - Use this skill when the input is a share short link, work URL, post URL, thread URL, homepage URL, platform ID, keyword, or entry page.
-- Route social-media retrieval requests through this skill first.
+- Route social-media retrieval requests through this skill first and call TikOmni API only.
 
 ## Supported Platforms
 
 - The currently supported platforms include Douyin, Xiaohongshu, Kuaishou, Bilibili, Weibo, TikTok, YouTube, Instagram, Threads, Twitter/X, Reddit, LinkedIn, WeChat Channels, Official Accounts, Toutiao, Xigua, Zhihu, Lemon8, and Pipixia.
 - Only four fixed pipelines are currently frozen: Douyin single work, Douyin creator home, Xiaohongshu single work, and Xiaohongshu creator home.
-- All other supported platform and object combinations should use the generic MCP workflow inside this skill.
+- All other supported platform and object combinations should use the API-only resolver and caller bundled with this skill.
 - See the official documentation for the full platform catalog and update policy: https://docs.tikomni.com
 
 ## What To Help With
 
-- Detect the platform and object type.
+- Detect the platform, capability, and object type.
+- Resolve a TikOmni API `endpoint_id` before making any request.
+- Show the recommended endpoint and available API alternatives.
 - Prefer single work, single post, thread, creator homepage, and content collection tasks.
 - Collect factual fields, platform text, subtitles, or transcript text.
 - Return structured JSON and write fact cards when required.
 
 ## Preferred Routing
 
-- Route all social-media objects into this skill first; do not jump straight to browser/CDP only because a fixed pipeline does not match.
+- Route all social-media objects into this skill first.
+- Do not construct TikOmni API paths manually.
+- Do not pass arbitrary `path` or `method` values to API callers.
 - If the object is one of the following four cases, prefer the fixed pipeline:
   1. Douyin single work
   2. Xiaohongshu single work
   3. Douyin creator home
   4. Xiaohongshu creator home
-- If no fixed pipeline matches, stay inside this skill and use the generic MCP path: `tools/list -> catalog.search -> endpoint.describe -> api.call`.
-- Use browser/CDP only when both the fixed pipeline and the generic MCP path are unavailable, or when the task explicitly requires page-level interaction that the API cannot satisfy. Record the reason in the result.
+- If no fixed pipeline matches, run `scripts/core/resolve_api_endpoint.py` first, then call `scripts/core/call_tikomni_api.py` with the returned `endpoint_id`.
+- For common deterministic tasks, prefer `scripts/run_task.py`.
+- If the resolver cannot determine a platform or capability, return a structured clarification request instead of guessing an endpoint.
 
 ## Working Style
 
-- Detect the platform and object type first, then choose between a fixed pipeline and the generic MCP path.
-- Treat browser/CDP as a fallback, not the default option.
+- Detect the platform and object type first, then choose between a fixed pipeline and API-only resolver/caller.
 - Prioritize factual fields and avoid subjective analysis.
 - Prefer native subtitles for video text; use ASR only when subtitles are unavailable.
 - Default to structured JSON plus Markdown and persist outputs proactively.
@@ -57,16 +61,16 @@ description: Use this skill when the user asks about social media links, posts,
 
 1. Detect the platform and object type.
 2. If a fixed pipeline matches, run the fixed script directly.
-3. If no fixed pipeline matches, call `tools/list` first, then choose the smallest MCP toolchain through `catalog.search -> endpoint.describe -> api.call`.
-4. If video text is required, run `u2.submit -> u2.query`; if it is still unfinished after the timeout, enter the U3 fallback path.
-5. Normalize the result into a structured payload.
-6. If the object is a work, write `work_fact_card`.
+3. If no fixed pipeline matches, resolve platform + capability to an `endpoint_id` with `scripts/core/resolve_api_endpoint.py`.
+4. Call TikOmni API with `scripts/core/call_tikomni_api.py`; never pass arbitrary API paths.
+5. If video text is required, use U2 ASR; use U3 media upload only to support video-to-text when media URLs are not directly usable.
+6. Normalize the result into a structured payload.
+7. If the object is a work, write `work_fact_card`.
 
 ## References
 
-- MCP usage contract: `references/mcp-usage-contract.md`
+- API routing contract: `references/api-routing-contract.md`
 - Output envelope: `references/contracts/output-envelope.md`
 - Work fact card fields: `references/contracts/work-fact-card-fields.md`
-- Generic MCP object guide: `references/guides/generic-mcp-objects.md`
 - U2/U3 rules: `references/service-guides/u2-u3-mandatory-fallback.md`
 - Fixed pipeline guides: `references/pipelines/`

package/skills/social-media-crawl/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "Social Media Crawl"
-  short_description: "Cross-platform structured social-media retrieval and archival"
-  default_prompt: "Use $social-media-crawl to fetch, transcribe, normalize, and archive social-media objects into structured JSON and work fact cards. Supported platforms include Douyin, Xiaohongshu, Kuaishou, Bilibili, Weibo, TikTok, YouTube, Instagram, Threads, Twitter/X, Reddit, LinkedIn, WeChat Channels, WeChat Official Accounts, Toutiao, Xigua, Zhihu, Lemon8, and Pipixia. Use fixed pipelines for Douyin/Xiaohongshu single-work and creator-home requests; use the MCP generic flow for other supported platforms and objects; use browser fallback only when the fixed pipelines and MCP path are insufficient."
+  short_description: "TikOmni API-only social-media retrieval, transcription, and archival"
+  default_prompt: "Use $social-media-crawl to fetch, transcribe, normalize, and archive social-media objects through TikOmni API. Supported platforms include Douyin, Xiaohongshu, Kuaishou, Bilibili, Weibo, TikTok, YouTube, Instagram, Threads, Twitter/X, Reddit, LinkedIn, WeChat Channels, WeChat Official Accounts, Toutiao, Xigua, Zhihu, Lemon8, and Pipixia. Resolve an endpoint_id before calling TikOmni API; use fixed pipelines for Douyin/Xiaohongshu single-work and creator-home requests."

package/skills/social-media-crawl/references/api-catalog/aliases.json

@@ -0,0 +1,237 @@
+{
+  "capabilities": {
+    "article_detail": [
+      "article",
+      "article_detail",
+      "公众号文章",
+      "文章内容",
+      "文章详情"
+    ],
+    "article_list": [
+      "article_list",
+      "文章列表"
+    ],
+    "article_url": [
+      "article_url",
+      "公众号链接",
+      "文章链接"
+    ],
+    "comments": [
+      "comment",
+      "comments",
+      "评论",
+      "评论列表"
+    ],
+    "general": [
+      "general"
+    ],
+    "hot_search": [
+      "hot search",
+      "hot words",
+      "hot_search",
+      "热搜",
+      "热榜"
+    ],
+    "livestream": [
+      "live",
+      "livestream",
+      "直播"
+    ],
+    "media_upload": [
+      "media_upload",
+      "upload",
+      "上传",
+      "媒体中转"
+    ],
+    "music": [
+      "music",
+      "音乐"
+    ],
+    "note_detail": [
+      "note",
+      "note_detail",
+      "小红书笔记",
+      "笔记",
+      "笔记详情"
+    ],
+    "product_detail": [
+      "goods",
+      "product",
+      "product_detail",
+      "商品",
+      "商品详情"
+    ],
+    "ranking": [
+      "rank",
+      "ranking",
+      "排行",
+      "榜单"
+    ],
+    "search": [
+      "search",
+      "搜索",
+      "检索"
+    ],
+    "transcription": [
+      "asr",
+      "transcription",
+      "字幕",
+      "语音识别",
+      "转写",
+      "转文案"
+    ],
+    "user_posts": [
+      "posts",
+      "user_posts",
+      "主页作品",
+      "作品列表"
+    ],
+    "user_profile": [
+      "author",
+      "creator",
+      "profile",
+      "user_profile",
+      "主页",
+      "用户信息"
+    ],
+    "video_detail": [
+      "video",
+      "video_detail",
+      "作品详情",
+      "单个视频",
+      "视频详情"
+    ]
+  },
+  "platforms": {
+    "bilibili": [
+      "b23.tv",
+      "bilibili",
+      "b站",
+      "哔哩哔哩"
+    ],
+    "demo": [
+      "demo"
+    ],
+    "douyin": [
+      "douyin",
+      "dy",
+      "iesdouyin.com",
+      "v.douyin.com",
+      "抖音"
+    ],
+    "douyin_search": [
+      "douyin_search"
+    ],
+    "health": [
+      "health"
+    ],
+    "hybrid": [
+      "hybrid"
+    ],
+    "instagram": [
+      "ig",
+      "ins",
+      "instagram"
+    ],
+    "ios_shortcut": [
+      "ios_shortcut"
+    ],
+    "kuaishou": [
+      "ks",
+      "kuaishou",
+      "快手"
+    ],
+    "lemon8": [
+      "lemon8"
+    ],
+    "linkedin": [
+      "linkedin",
+      "领英"
+    ],
+    "pipixia": [
+      "pipixia",
+      "皮皮虾"
+    ],
+    "reddit": [
+      "reddit"
+    ],
+    "sora2": [
+      "sora2"
+    ],
+    "temp_mail": [
+      "temp_mail"
+    ],
+    "threads": [
+      "threads"
+    ],
+    "tiktok": [
+      "tik tok",
+      "tiktok"
+    ],
+    "toutiao": [
+      "toutiao",
+      "今日头条",
+      "头条"
+    ],
+    "twitter": [
+      "twitter",
+      "x",
+      "x.com",
+      "推特"
+    ],
+    "u2": [
+      "asr",
+      "transcription",
+      "u2",
+      "语音转写",
+      "转文案"
+    ],
+    "u3": [
+      "media upload",
+      "u3",
+      "upload",
+      "中转",
+      "媒体上传"
+    ],
+    "wechat": [
+      "wechat"
+    ],
+    "wechat_channels": [
+      "wechat channels",
+      "wechat_channels",
+      "微信视频号",
+      "视频号"
+    ],
+    "wechat_mp": [
+      "mp.weixin.qq.com",
+      "wechat official accounts",
+      "wechat_mp",
+      "公众号",
+      "微信公众号"
+    ],
+    "weibo": [
+      "weibo",
+      "微博"
+    ],
+    "xiaohongshu": [
+      "xhs",
+      "xhslink.com",
+      "xiaohongshu",
+      "xiaohongshu.com",
+      "小红书"
+    ],
+    "xigua": [
+      "xigua",
+      "西瓜视频"
+    ],
+    "youtube": [
+      "youtu.be",
+      "youtube",
+      "yt"
+    ],
+    "zhihu": [
+      "zhihu",
+      "知乎"
+    ]
+  }
+}