@tikomni/skills 0.1.0

package/skills/meta-capability/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: meta-capability
+description: Use this skill for cross-platform content retrieval and analysis tasks. Trigger when the user asks to extract / fetch / inspect / organize / analyze, or 抓取 / 提取 / 查询 / 整理 / 分析, and the target is a concrete platform object such as a single content item, profile, comment thread, search result, ranking, livestream, or product page.
+---
+
+# Meta Capability
+
+## When To Use
+
+- Use this skill when the user already knows what they want to work on and wants a usable result.
+- Use this skill for a single video, post, article, note, profile, creator page, comment thread, search result set, ranking, livestream, product page, or another concrete platform object.
+- Use this skill when the user provides a link, share URL, page URL, platform ID, keyword, handle, or another clear entry point.
+- Use this skill for general TikOmni tasks that require actual retrieval, extraction, organization, or analysis.
+
+## What It Can Do
+
+- Fetch and organize data for single content items.
+- Fetch and organize data for profiles, creator pages, and content collections.
+- Retrieve comments, replies, search results, rankings, livestream data, commerce-related data, and other supported platform objects.
+- Extract captions, subtitles, transcripts, media URLs, author information, and engagement metrics when available.
+- Return structured facts and analysis grounded in retrieved data.
+- Return a reduced but still usable result when some fields are unavailable.
+
+## Core Rules
+
+- Start from the user's actual target object, not from the API catalog.
+- Prefer the smallest route chain that can complete the task.
+- Keep retrieved facts separate from inferred analysis.
+- Base every conclusion on retrieved data only.
+- Prefer platform-native text, subtitles, and structured fields first.
+- If the task needs transcription and the media URL may not be publicly readable, follow the U2/U3 fallback guide.
+- If required fields are missing, return the best clear partial result instead of fabricating data.
+
+## Do Not
+
+- Do not present guessed values as retrieved facts.
+- Do not promise fields that the selected route chain cannot actually provide.
+- Do not stop at route lookup if the user is clearly asking for actual retrieval or analysis.
+- Do not stop the task just because a more specialized skill is unavailable; continue here when needed.
+
+## Workflow
+
+1. Read `references/api-capability-index.md` to identify the relevant platform, task type, auth pattern, tag file, and contract file.
+2. Read the relevant files under `references/api-tags/` to confirm route summaries, key inputs, auth requirements, and key success responses.
+3. Read the relevant files under `references/api-contracts/` only when exact field definitions, defaults, examples, or full success-response structures are needed.
+4. If the task already matches a validated route chain, read `references/implemented-route-map.md` first.
+5. If auth needs to be verified, run `python3 "skills/meta-capability/scripts/test_auth.py"`.
+6. If a route needs to be called manually, run `python3 "skills/meta-capability/scripts/call_route.py" METHOD PATH --params-json '...' --body-json '...'`.
+7. Read `references/execution-guidelines.md` to confirm object type, target fields, output shape, and fallback behavior.
+8. If the task involves ASR timeout, non-public media URLs, or U3 media relay, read `references/service-guides/asr-u2-u3-fallback.md`.
+9. Read `references/dispatch.md` to determine whether a more specialized skill is a better fit.
+10. If a better specialized skill is available in the current skill workspace, hand off with the confirmed routes, retrieved facts, and intermediate findings.
+11. If that specialized skill is missing, not installed, not checked out, or otherwise unavailable in the current workspace, continue in this skill and complete the task here.
+
+## References
+
+- API capability index: `references/api-capability-index.md`
+- Tag-level route summaries: `references/api-tags/`
+- Tag-level full contracts: `references/api-contracts/`
+- Validated route chains: `references/implemented-route-map.md`
+- Execution guidelines: `references/execution-guidelines.md`
+- ASR and U3 fallback guide: `references/service-guides/asr-u2-u3-fallback.md`
+- Dispatch guidance: `references/dispatch.md`
+
+## Scripts
+
+- Auth test: `scripts/test_auth.py`
+- Manual route call: `scripts/call_route.py`
+- Runtime defaults: `references/config-templates/defaults.yaml`

package/skills/meta-capability/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Meta Capability"
+  short_description: "Cross-platform content retrieval, routing, and analysis"
+  default_prompt: "Use $meta-capability to handle a concrete platform object such as a single content item, profile, comment thread, search result, ranking, livestream, or product page."

package/skills/meta-capability/env.example

@@ -0,0 +1,42 @@
+# [ZH] 本文件是 meta-capability 的环境变量示例。
+# [EN] This file is the env example for meta-capability.
+#
+# [ZH] 正常情况下，请先把仓库根 env.example 复制到 skills/.env。
+# [EN] In normal use, copy the repo-root env.example to skills/.env first.
+#
+# [ZH] 只有当 meta-capability 需要局部覆盖时，才把下面字段复制到本目录的 .env.local。
+# [EN] Only copy selected keys into this folder's .env.local when meta-capability needs local overrides.
+
+# [ZH] TikOmni API Key。默认值：无。meta-capability 发请求时必填。
+# [EN] TikOmni API key. Default: none. Required when meta-capability sends requests.
+# [ZH] 运行脚本时会自动组装请求头：Authorization: Bearer {token}
+# [EN] Runtime scripts will automatically build the header: Authorization: Bearer {token}
+TIKOMNI_API_KEY=""
+
+# [ZH] TikOmni API 基础地址。默认值：https://api.tikomni.com
+# [EN] TikOmni API base URL. Default: https://api.tikomni.com
+TIKOMNI_BASE_URL="https://api.tikomni.com"
+
+# [ZH] HTTP 请求超时，单位毫秒。默认值：60000
+# [EN] HTTP request timeout in milliseconds. Default: 60000
+TIKOMNI_TIMEOUT_MS="60000"
+
+# [ZH] 全局请求 QPS 节流。默认值：5.0
+# [EN] Global request QPS throttle. Default: 5.0
+TIKOMNI_GLOBAL_QPS="5.0"
+
+# [ZH] 超时后的最大重试次数。默认值：3
+# [EN] Max retry count after timeout. Default: 3
+TIKOMNI_TIMEOUT_RETRY_MAX="3"
+
+# [ZH] 超时重试退避，单位毫秒。默认值：300
+# [EN] Timeout retry backoff in milliseconds. Default: 300
+TIKOMNI_TIMEOUT_RETRY_BACKOFF_MS="300"
+
+# [ZH] 显式配置文件路径。默认值：空；留空时自动使用本模块 defaults.yaml
+# [EN] Explicit config file path. Default: empty; when empty the module uses its own defaults.yaml
+# TIKOMNI_CONFIG_FILE=""
+
+# [ZH] 可选：覆盖 API Key 的环境变量名。默认值：TIKOMNI_API_KEY
+# [EN] Optional: override the env var name that stores the API key. Default: TIKOMNI_API_KEY
+# TIKOMNI_AUTH_ENV_KEY="TIKOMNI_API_KEY"

package/skills/meta-capability/references/api-capability-index.md

@@ -0,0 +1,92 @@
+# TikOmni API Capability Index
+
+## Purpose
+
+- This auto-generated lightweight entry point helps identify the right tag, capability area, and auth pattern first.
+- Source mode: `remote`
+- Source: `https://app.tikomni.com/openapi/tikomni-openapi.full.with-u2.public.latest.json`
+- Fetched at: `2026-03-08T06:54:04+00:00`
+- Start route selection here. Read `api-tags/` and `api-contracts/` only when you need field definitions, defaults, examples, or full response structures.
+- If the task involves ASR timeout, non-public media URLs, or U3 media relay, also read `service-guides/asr-u2-u3-fallback.md`.
+
+## Global Auth
+
+- Default auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- If a route overrides or disables the default auth requirement, trust the corresponding `api-tags/` and `api-contracts/` entries.
+
+## Read Order
+
+1. Choose a tag by platform and object type.
+2. Open `api-tags/<tag>.md` for route summaries, auth requirements, and key fields.
+3. Open `api-contracts/<tag>.md` only when you need exact field definitions, defaults, examples, or full success-response structures.
+4. If the task involves transcription, the 90-second soft observation window, or the 120-second hard fallback, read the U2/U3 guide.
+
+## Stats
+
+- Tag groups: `53`
+- Routes: `991`
+- Generated targets: `3` skill reference sets
+
+## Special Flows
+
+- ASR and U3 fallback: [`service-guides/asr-u2-u3-fallback.md`](./service-guides/asr-u2-u3-fallback.md)
+- ASR tag: [`api-tags/asr-api.md`](./api-tags/asr-api.md)
+- U3 media relay tag: [`api-tags/media-ingest-api.md`](./api-tags/media-ingest-api.md)
+
+## Tag Overview
+
+| Tag | File | Contract | Ops | Auth | Common Capabilities | Common Inputs |
+| --- | --- | --- | ---: | --- | --- | --- |
+| `ASR-API` | [`api-tags/asr-api.md`](./api-tags/asr-api.md) | [`api-contracts/asr-api.md`](./api-contracts/asr-api.md) | 2 | Header `Authorization` Bearer | ASR / transcription / audio / media / general | `input`, `task_id` |
+| `Bilibili-App-API` | [`api-tags/bilibili-app-api.md`](./api-tags/bilibili-app-api.md) | [`api-contracts/bilibili-app-api.md`](./api-contracts/bilibili-app-api.md) | 11 | Header `Authorization` Bearer | general / profiles / accounts / content details / search | `av_id`, `bv_id`, `page`, `idx`, `next_offset`, `ps`, `keyword`, `page_size`, `order`, `user_id` |
+| `Bilibili-Web-API` | [`api-tags/bilibili-web-api.md`](./api-tags/bilibili-web-api.md) | [`api-contracts/bilibili-web-api.md`](./api-contracts/bilibili-web-api.md) | 30 | Header `Authorization` Bearer | content details / profiles / accounts / livestream / details | `bv_id`, `uid`, `pn`, `cid`, `dynamic_id`, `order`, `room_id`, `a_id`, `c_id`, `url` |
+| `Demo-API` | [`api-tags/demo-api.md`](./api-tags/demo-api.md) | [`api-contracts/demo-api.md`](./api-contracts/demo-api.md) | 9 | Header `Authorization` Bearer | content details / profiles / accounts / general / search | None |
+| `Douyin-App-V3-API` | [`api-tags/douyin-app-v3-api.md`](./api-tags/douyin-app-v3-api.md) | [`api-contracts/douyin-app-v3-api.md`](./api-contracts/douyin-app-v3-api.md) | 47 | Header `Authorization` Bearer | content details / search / profiles / accounts / details | `count`, `cursor`, `keyword`, `aweme_id`, `sec_user_id`, `offset`, `sort_type`, `publish_time`, `filter_duration`, `aweme_ids` |
+| `Douyin-Billboard-API` | [`api-tags/douyin-billboard-api.md`](./api-tags/douyin-billboard-api.md) | [`api-contracts/douyin-billboard-api.md`](./api-contracts/douyin-billboard-api.md) | 31 | Header `Authorization` Bearer | trends / rankings / search / topics / details | `page_size`, `date_window`, `page`, `keyword`, `tags`, `sec_uid`, `option`, `page_num`, `end_date`, `start_date` |
+| `Douyin-Creator-API` | [`api-tags/douyin-creator-api.md`](./api-tags/douyin-creator-api.md) | [`api-contracts/douyin-creator-api.md`](./api-contracts/douyin-creator-api.md) | 16 | Header `Authorization` Bearer | creators / trends / rankings / topics / details | `billboard_tag`, `order_key`, `time_filter`, `limit`, `offset`, `category_id`, `order`, `activity_id`, `start_time`, `end_time` |
+| `Douyin-Creator-V2-API` | [`api-tags/douyin-creator-v2-api.md`](./api-tags/douyin-creator-v2-api.md) | [`api-contracts/douyin-creator-v2-api.md`](./api-contracts/douyin-creator-v2-api.md) | 14 | Header `Authorization` Bearer | creators / media / download / search / trends / rankings | `cookie`, `item_id`, `start_date`, `end_date`, `genres`, `primary_verticals`, `fields`, `need_long_article`, `metric_type`, `count` |
+| `Douyin-Search-API` | [`api-tags/douyin-search-api.md`](./api-tags/douyin-search-api.md) | [`api-contracts/douyin-search-api.md`](./api-contracts/douyin-search-api.md) | 20 | Header `Authorization` Bearer | search / topics / profiles / accounts / content details | `keyword`, `cursor`, `search_id`, `sort_type`, `publish_time`, `filter_duration`, `content_type`, `backtrace`, `douyin_user_fans`, `douyin_user_type` |
+| `Douyin-Web-API` | [`api-tags/douyin-web-api.md`](./api-tags/douyin-web-api.md) | [`api-contracts/douyin-web-api.md`](./api-contracts/douyin-web-api.md) | 76 | Header `Authorization` Bearer | profiles / accounts / content details / general / livestream | `count`, `cookie`, `refresh_index`, `keyword`, `sec_user_id`, `cursor`, `room_id`, `offset`, `aweme_id`, `max_cursor` |
+| `Douyin-Xingtu-API` | [`api-tags/douyin-xingtu-api.md`](./api-tags/douyin-xingtu-api.md) | [`api-contracts/douyin-xingtu-api.md`](./api-contracts/douyin-xingtu-api.md) | 22 | Header `Authorization` Bearer | general / content details / comments / trends / rankings | `kolId`, `platformChannel`, `_range`, `page`, `onlyAssign`, `keyword`, `uri`, `durationTS`, `format`, `sec_user_id` |
+| `Douyin-Xingtu-V2-API` | [`api-tags/douyin-xingtu-v2-api.md`](./api-tags/douyin-xingtu-v2-api.md) | [`api-contracts/douyin-xingtu-v2-api.md`](./api-contracts/douyin-xingtu-v2-api.md) | 21 | Header `Authorization` Bearer | creators / general / trends / rankings / comments | `o_author_id`, `platform_source`, `limit`, `platform_channel`, `author_id`, `only_assign`, `flow_type`, `page`, `qualifier`, `period` |
+| `Health-Check` | [`api-tags/health-check.md`](./api-tags/health-check.md) | [`api-contracts/health-check.md`](./api-contracts/health-check.md) | 1 | Header `Authorization` Bearer | general | None |
+| `Hybrid-Parsing` | [`api-tags/hybrid-parsing.md`](./api-tags/hybrid-parsing.md) | [`api-contracts/hybrid-parsing.md`](./api-contracts/hybrid-parsing.md) | 1 | Header `Authorization` Bearer | content details | `url`, `minimal`, `base64_url` |
+| `Instagram-V1-API` | [`api-tags/instagram-v1-api.md`](./api-tags/instagram-v1-api.md) | [`api-contracts/instagram-v1-api.md`](./api-contracts/instagram-v1-api.md) | 29 | Header `Authorization` Bearer | profiles / accounts / content details / general / comments | `user_id`, `max_id`, `count`, `end_cursor`, `media_id`, `username`, `page`, `min_id`, `location_id`, `post_url` |
+| `Instagram-V2-API` | [`api-tags/instagram-v2-api.md`](./api-tags/instagram-v2-api.md) | [`api-contracts/instagram-v2-api.md`](./api-contracts/instagram-v2-api.md) | 27 | Header `Authorization` Bearer | profiles / accounts / content details / search / comments | `pagination_token`, `user_id`, `username`, `keyword`, `code_or_url`, `comment_id`, `feed_type`, `highlight_id`, `location_id`, `audio_canonical_id` |
+| `Instagram-V3-API` | [`api-tags/instagram-v3-api.md`](./api-tags/instagram-v3-api.md) | [`api-contracts/instagram-v3-api.md`](./api-contracts/instagram-v3-api.md) | 26 | Header `Authorization` Bearer | profiles / accounts / content details / comments / search | `user_id`, `username`, `url`, `first`, `after`, `query`, `media_id`, `code`, `max_id`, `comment_id` |
+| `Kuaishou-App-API` | [`api-tags/kuaishou-app-api.md`](./api-tags/kuaishou-app-api.md) | [`api-contracts/kuaishou-app-api.md`](./api-contracts/kuaishou-app-api.md) | 20 | Header `Authorization` Bearer | content details / trends / rankings / profiles / accounts / search | `pcursor`, `user_id`, `subTabId`, `subTabName`, `keyword`, `magic_face_id`, `photo_id`, `page`, `boardType`, `boardId` |
+| `Kuaishou-Web-API` | [`api-tags/kuaishou-web-api.md`](./api-tags/kuaishou-web-api.md) | [`api-contracts/kuaishou-web-api.md`](./api-contracts/kuaishou-web-api.md) | 13 | Header `Authorization` Bearer | content details / profiles / accounts / trends / rankings / comments | `pcursor`, `photo_id`, `user_id`, `share_link`, `board_type`, `share_text`, `url`, `root_comment_id` |
+| `Lemon8-App-API` | [`api-tags/lemon8-app-api.md`](./api-tags/lemon8-app-api.md) | [`api-contracts/lemon8-app-api.md`](./api-contracts/lemon8-app-api.md) | 16 | Header `Authorization` Bearer | general / profiles / accounts / content details / search | `user_id`, `item_id`, `cursor`, `share_text`, `group_id`, `media_id`, `offset`, `query`, `max_cursor`, `filter_type` |
+| `LinkedIn-Web-API` | [`api-tags/linkedin-web-api.md`](./api-tags/linkedin-web-api.md) | [`api-contracts/linkedin-web-api.md`](./api-contracts/linkedin-web-api.md) | 25 | Header `Authorization` Bearer | profiles / accounts / general / content details / search | `page`, `urn`, `company_id`, `pagination_token`, `sort_by`, `company`, `username`, `date_posted`, `experience_level`, `remote` |
+| `Media-Ingest-API` | [`api-tags/media-ingest-api.md`](./api-tags/media-ingest-api.md) | [`api-contracts/media-ingest-api.md`](./api-contracts/media-ingest-api.md) | 2 | Header `Authorization` Bearer | media upload / public URL | `provider`, `file_name`, `content_type`, `size_bytes`, `upload_id` |
+| `PiPiXia-App-API` | [`api-tags/pipixia-app-api.md`](./api-tags/pipixia-app-api.md) | [`api-contracts/pipixia-app-api.md`](./api-contracts/pipixia-app-api.md) | 17 | Header `Authorization` Bearer | content details / profiles / accounts / search / details | `cursor`, `cell_id`, `user_id`, `cell_type`, `hashtag_id`, `feed_count`, `offset`, `hashtag_request_type`, `hashtag_sort_type`, `page` |
+| `Reddit-APP-API` | [`api-tags/reddit-app-api.md`](./api-tags/reddit-app-api.md) | [`api-contracts/reddit-app-api.md`](./api-contracts/reddit-app-api.md) | 24 | Header `Authorization` Bearer | general / profiles / accounts / content details / comments | `need_format`, `after`, `sort`, `username`, `subreddit_name`, `subreddit_id`, `post_id`, `filter_posts`, `include_comment_id`, `comment_id` |
+| `Sora2-API` | [`api-tags/sora2-api.md`](./api-tags/sora2-api.md) | [`api-contracts/sora2-api.md`](./api-contracts/sora2-api.md) | 17 | Header `Authorization` Bearer | content details / profiles / accounts / general / comments | `cursor`, `user_id`, `post_id`, `post_url`, `task_id`, `prompt`, `orientation`, `media_id`, `comment_id`, `eager_views` |
+| `Temp-Mail-API` | [`api-tags/temp-mail-api.md`](./api-tags/temp-mail-api.md) | [`api-contracts/temp-mail-api.md`](./api-contracts/temp-mail-api.md) | 3 | Header `Authorization` Bearer | general | `token`, `message_id` |
+| `Threads-Web-API` | [`api-tags/threads-web-api.md`](./api-tags/threads-web-api.md) | [`api-contracts/threads-web-api.md`](./api-contracts/threads-web-api.md) | 11 | Header `Authorization` Bearer | profiles / accounts / content details / search / details | `end_cursor`, `user_id`, `post_id`, `query`, `url`, `username` |
+| `TikHub-Downloader-API` | [`api-tags/tikhub-downloader-api.md`](./api-tags/tikhub-downloader-api.md) | [`api-contracts/tikhub-downloader-api.md`](./api-contracts/tikhub-downloader-api.md) | 2 | Header `Authorization` Bearer | media / download | None |
+| `TikHub-User-API` | [`api-tags/tikhub-user-api.md`](./api-tags/tikhub-user-api.md) | [`api-contracts/tikhub-user-api.md`](./api-contracts/tikhub-user-api.md) | 6 | Header `Authorization` Bearer | profiles / accounts | `endpoint`, `request_per_day` |
+| `TikTok-Ads-API` | [`api-tags/tiktok-ads-api.md`](./api-tags/tiktok-ads-api.md) | [`api-contracts/tiktok-ads-api.md`](./api-contracts/tiktok-ads-api.md) | 31 | Header `Authorization` Bearer | ads / search / details / creators | `limit`, `page`, `country_code`, `period`, `keyword`, `period_type`, `industry`, `order_by`, `rank_type`, `material_id` |
+| `TikTok-Analytics-API` | [`api-tags/tiktok-analytics-api.md`](./api-tags/tiktok-analytics-api.md) | [`api-contracts/tiktok-analytics-api.md`](./api-contracts/tiktok-analytics-api.md) | 4 | Header `Authorization` Bearer | analytics / comments / creators / content details | `item_id`, `content_category`, `user_id` |
+| `TikTok-App-V3-API` | [`api-tags/tiktok-app-v3-api.md`](./api-tags/tiktok-app-v3-api.md) | [`api-contracts/tiktok-app-v3-api.md`](./api-contracts/tiktok-app-v3-api.md) | 75 | Header `Authorization` Bearer | content details / commerce / profiles / accounts / search | `count`, `offset`, `keyword`, `sort_type`, `cursor`, `region`, `sec_user_id`, `user_id`, `room_id`, `seller_id` |
+| `TikTok-Creator-API` | [`api-tags/tiktok-creator-api.md`](./api-tags/tiktok-creator-api.md) | [`api-contracts/tiktok-creator-api.md`](./api-contracts/tiktok-creator-api.md) | 14 | Header `Authorization` Bearer | creators / content details / analytics / commerce | `cookie`, `proxy`, `start_date`, `item_id`, `page`, `product_id`, `end_date`, `count`, `offset`, `item_ids` |
+| `TikTok-Interaction-API` | [`api-tags/tiktok-interaction-api.md`](./api-tags/tiktok-interaction-api.md) | [`api-contracts/tiktok-interaction-api.md`](./api-contracts/tiktok-interaction-api.md) | 7 | Header `Authorization` Bearer | general / comments / content details / comment replies | `cookie`, `device_id`, `iid`, `proxy`, `aweme_id`, `text`, `api_key`, `invite_code`, `user_id`, `sec_user_id` |
+| `TikTok-Shop-Web-API` | [`api-tags/tiktok-shop-web-api.md`](./api-tags/tiktok-shop-web-api.md) | [`api-contracts/tiktok-shop-web-api.md`](./api-contracts/tiktok-shop-web-api.md) | 15 | Header `Authorization` Bearer | commerce / search / details / trends / rankings | `region`, `product_id`, `offset`, `seller_id`, `search_word`, `page_token`, `lang`, `count`, `sort_type`, `filter_id` |
+| `TikTok-Web-API` | [`api-tags/tiktok-web-api.md`](./api-tags/tiktok-web-api.md) | [`api-contracts/tiktok-web-api.md`](./api-contracts/tiktok-web-api.md) | 58 | Header `Authorization` Bearer | general / profiles / accounts / livestream / content details | `count`, `cursor`, `cookie`, `secUid`, `url`, `keyword`, `search_id`, `user_agent`, `offset`, `coverFormat` |
+| `Toutiao-App-API` | [`api-tags/toutiao-app-api.md`](./api-tags/toutiao-app-api.md) | [`api-contracts/toutiao-app-api.md`](./api-contracts/toutiao-app-api.md) | 5 | Header `Authorization` Bearer | content details / profiles / accounts / comments | `group_id`, `offset`, `user_profile_url`, `user_id` |
+| `Toutiao-Web-API` | [`api-tags/toutiao-web-api.md`](./api-tags/toutiao-web-api.md) | [`api-contracts/toutiao-web-api.md`](./api-contracts/toutiao-web-api.md) | 2 | Header `Authorization` Bearer | content details | `aweme_id` |
+| `Twitter-Web-API` | [`api-tags/twitter-web-api.md`](./api-tags/twitter-web-api.md) | [`api-contracts/twitter-web-api.md`](./api-contracts/twitter-web-api.md) | 13 | Header `Authorization` Bearer | profiles / accounts / content details / comments / search | `cursor`, `screen_name`, `tweet_id`, `rest_id`, `keyword`, `search_type`, `country`, `userId`, `count` |
+| `WeChat-Channels-API` | [`api-tags/wechat-channels-api.md`](./api-tags/wechat-channels-api.md) | [`api-contracts/wechat-channels-api.md`](./api-contracts/wechat-channels-api.md) | 9 | Header `Authorization` Bearer | profiles / accounts / search / comments / trends / rankings | `keywords`, `id`, `username`, `lastBuffer`, `comment_id`, `session_buffer`, `last_buffer`, `page`, `exportId` |
+| `WeChat-Media-Platform-Web-API` | [`api-tags/wechat-media-platform-web-api.md`](./api-tags/wechat-media-platform-web-api.md) | [`api-contracts/wechat-media-platform-web-api.md`](./api-contracts/wechat-media-platform-web-api.md) | 10 | Header `Authorization` Bearer | content details / comments / details / comment replies | `url`, `comment_id`, `offset`, `buffer`, `content_id`, `ghid`, `sogou_url` |
+| `Weibo-App-API` | [`api-tags/weibo-app-api.md`](./api-tags/weibo-app-api.md) | [`api-contracts/weibo-app-api.md`](./api-contracts/weibo-app-api.md) | 20 | Header `Authorization` Bearer | profiles / accounts / content details / search / details | `uid`, `page`, `since_id`, `status_id`, `query`, `count`, `max_id`, `category`, `search_type`, `sort_type` |
+| `Weibo-Web-API` | [`api-tags/weibo-web-api.md`](./api-tags/weibo-web-api.md) | [`api-contracts/weibo-web-api.md`](./api-contracts/weibo-web-api.md) | 11 | Header `Authorization` Bearer | profiles / accounts / search / content details / comments | `page`, `max_id`, `post_id`, `uid`, `channel_name`, `cid`, `mid`, `max_id_type`, `keyword`, `search_type` |
+| `Weibo-Web-V2-API` | [`api-tags/weibo-web-v2-api.md`](./api-tags/weibo-web-v2-api.md) | [`api-contracts/weibo-web-v2-api.md`](./api-contracts/weibo-web-v2-api.md) | 33 | Header `Authorization` Bearer | search / profiles / accounts / content details / general | `page`, `uid`, `query`, `id`, `max_id`, `count`, `since_id`, `q`, `keyword`, `cursor` |
+| `Xiaohongshu-App-API` | [`api-tags/xiaohongshu-app-api.md`](./api-tags/xiaohongshu-app-api.md) | [`api-contracts/xiaohongshu-app-api.md`](./api-contracts/xiaohongshu-app-api.md) | 12 | Header `Authorization` Bearer | content details / profiles / accounts / comments / commerce | `note_id`, `session_id`, `share_link`, `start`, `share_text`, `sort`, `user_id`, `keyword`, `page`, `search_id` |
+| `Xiaohongshu-App-V2-API` | [`api-tags/xiaohongshu-app-v2-api.md`](./api-tags/xiaohongshu-app-v2-api.md) | [`api-contracts/xiaohongshu-app-v2-api.md`](./api-contracts/xiaohongshu-app-v2-api.md) | 21 | Header `Authorization` Bearer | content details / commerce / search / details | `source`, `share_text`, `cursor`, `note_id`, `page`, `keyword`, `search_id`, `sku_id`, `user_id`, `tab` |
+| `Xiaohongshu-Web-API` | [`api-tags/xiaohongshu-web-api.md`](./api-tags/xiaohongshu-web-api.md) | [`api-contracts/xiaohongshu-web-api.md`](./api-contracts/xiaohongshu-web-api.md) | 17 | Header `Authorization` Bearer | content details / profiles / accounts / search / comments | `note_id`, `share_text`, `cookie`, `proxy`, `lastCursor`, `user_id`, `keyword`, `page`, `xsec_token`, `sort` |
+| `Xiaohongshu-Web-V2-API` | [`api-tags/xiaohongshu-web-v2-api.md`](./api-tags/xiaohongshu-web-v2-api.md) | [`api-contracts/xiaohongshu-web-v2-api.md`](./api-contracts/xiaohongshu-web-v2-api.md) | 18 | Header `Authorization` Bearer | content details / profiles / accounts / general / comments | `note_id`, `user_id`, `cursor`, `page`, `keywords`, `short_url`, `sort_type`, `note_type`, `comment_id` |
+| `Xigua-App-V2-API` | [`api-tags/xigua-app-v2-api.md`](./api-tags/xigua-app-v2-api.md) | [`api-contracts/xigua-app-v2-api.md`](./api-contracts/xigua-app-v2-api.md) | 7 | Header `Authorization` Bearer | content details / profiles / accounts / comments / search | `item_id`, `user_id`, `offset`, `max_behot_time`, `count`, `keyword`, `order_type`, `min_duration`, `max_duration` |
+| `YouTube-Web-API` | [`api-tags/youtube-web-api.md`](./api-tags/youtube-web-api.md) | [`api-contracts/youtube-web-api.md`](./api-contracts/youtube-web-api.md) | 21 | Header `Authorization` Bearer | content details / profiles / accounts / search / comments | `continuation_token`, `language_code`, `country_code`, `channel_id`, `video_id`, `need_format`, `search_query`, `sort_by`, `lang`, `time_zone` |
+| `YouTube-Web-V2-API` | [`api-tags/youtube-web-v2-api.md`](./api-tags/youtube-web-v2-api.md) | [`api-contracts/youtube-web-v2-api.md`](./api-contracts/youtube-web-v2-api.md) | 16 | Header `Authorization` Bearer | content details / profiles / accounts / search / livestream | `continuation_token`, `need_format`, `language_code`, `country_code`, `video_id`, `channel_id`, `video_url`, `sort_by`, `channel_url`, `search_query` |
+| `Zhihu-Web-API` | [`api-tags/zhihu-web-api.md`](./api-tags/zhihu-web-api.md) | [`api-contracts/zhihu-web-api.md`](./api-contracts/zhihu-web-api.md) | 32 | Header `Authorization` Bearer | search / profiles / accounts / content details / general | `offset`, `limit`, `keyword`, `user_url_token`, `search_hash_id`, `article_id`, `order_by`, `message_content`, `message_id`, `show_all_topics` |
+| `iOS-Shortcut` | [`api-tags/ios-shortcut.md`](./api-tags/ios-shortcut.md) | [`api-contracts/ios-shortcut.md`](./api-contracts/ios-shortcut.md) | 1 | Header `Authorization` Bearer | general | None |

package/skills/meta-capability/references/api-contracts/asr-api.md

@@ -0,0 +1,130 @@
+# ASR-API Full Contract
+
+- Back to index: [`api-capability-index.md`](../api-capability-index.md)
+- Back to route summary: [`api-tags/asr-api.md`](../api-tags/asr-api.md)
+- Current contract file: `api-contracts/asr-api.md`
+- Source: `https://app.tikomni.com/openapi/tikomni-openapi.full.with-u2.public.latest.json`
+- Fetched at: `2026-03-08T06:54:04+00:00`
+- Route count: `2`
+- Default auth: Header `Authorization` Bearer
+- Read this file only when you need precise auth notes, parameter descriptions, defaults, examples, or success-response fields.
+- Tag description: **(ASR 异步任务接口 / ASR async task endpoints)**
+
+## Route Contracts
+
+<a id="post-api-u2-v1-services-audio-asr-transcription"></a>
+### `POST /api/u2/v1/services/audio/asr/transcription`
+
+- Summary: u2 submit
+- Capabilities: ASR / transcription / audio / media
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `u2Submit`
+
+#### Notes
+
+> 创建异步转写任务。单次请求支持 1..100 条 input.file_urls；大批量建议优先批量 submit，避免拆分大量单条 submit。submit 返回 200 仅表示已受理，最终状态请以 query 判定 / Create async transcription task. One request accepts 1..100 input.file_urls. For large workloads, prefer batch submit instead of many single submits. Submit 200 only means accepted; final status must be judged via query endpoint.
+
+#### Parameters
+
+None
+
+#### Request Body
+
+- required: Yes
+
+##### `application/json`
+
+- Schema summary: `input*`{`file_urls*`[string(uri)]}
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| input | object | Yes | None | None | None | None |
+| input.file_urls | array<string(uri)> | Yes | 批量提交 URL，单次范围 1..100；大批量建议优先单次批量提交，避免拆分大量单条 submit / Batch submit URLs, range 1..100 per request. For large workloads, prefer one batch submit over many single submits. | None | None | None |
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `request_id*`:string, `output*`{`task_id*`:string, `task_status*`:string, `submit_time`:string, `scheduled_time`:string, `end_time`:string, `task_metrics`{...}, `results`[object]}, `usage`{...}
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| request_id | string | Yes | None | None | None | None |
+| output | object | Yes | None | None | None | None |
+| output.task_id | string | Yes | None | None | None | None |
+| output.task_status | string | Yes | Submit usually returns PENDING/RUNNING. Final status should be checked via query endpoint. | None | PENDING | None |
+| output.submit_time | string | No | None | None | None | None |
+| output.scheduled_time | string | No | None | None | None | None |
+| output.end_time | string | No | None | None | None | None |
+| output.task_metrics | object | No | None | None | None | None |
+| output.results | array<object> | No | None | None | None | None |
+| output.results[] | object | Yes | None | None | None | None |
+| usage | object | No | None | None | None | None |
+
+<a id="post-api-u2-v1-tasks-task-id"></a>
+### `POST /api/u2/v1/tasks/{task_id}`
+
+- Summary: u2 query
+- Capabilities: general
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- operationId: `u2Query`
+
+#### Notes
+
+> 查询任务状态。网关保留上游 task_status，并返回平台聚合状态。若客户端不轮询，平台也会在后台持续 reconcile 直到拿到终态并完成结算。判定规则：全部成功=platform_task_status=SUCCEEDED 且 pending_count=0；部分成功=PARTIAL_SUCCEEDED 且 pending_count=0；失败=FAILED 且 pending_count=0；处理中=pending_count>0。sentences/full_text 仅在全部成功时返回 / Query task status. The gateway preserves the upstream task_status and also returns platform aggregate status. Even if clients stop polling, the platform continues background reconcile until the task reaches a terminal state and billing is settled. Completion rules: SUCCEEDED => platform_task_status=SUCCEEDED and pending_count=0; PARTIAL => PARTIAL_SUCCEEDED and pending_count=0; FAILED => FAILED and pending_count=0; in-progress => pending_count>0. sentences/full_text are returned only when all items succeed.
+
+#### Parameters
+
+| Field | In | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| task_id | path | string | Yes | None | None | None | None |
+
+#### Request Body
+
+None
+
+#### Success Response
+
+##### `200 application/json`
+
+- Schema summary: `time*`:string, `time_stamp*`:integer, `time_zone*`:string, `params*`{`task_id*`:string}, `data*`{`task_id*`:string, `task_status*`:string | null, `platform_task_status*`:string, `is_fully_succeeded*`:boolean, `submit_time`:string, `scheduled_time`:string, `end_time`:string, `task_metrics`{...}, ...}, `code*`:integer, `request_id*`:string, `message*`:string, ...
+
+| Field | Type | Required | Description | Default | Example | Enum |
+| --- | --- | --- | --- | --- | --- | --- |
+| time | string | Yes | Platform response time (America/Los_Angeles). | None | None | None |
+| time_stamp | integer | Yes | Unix timestamp in seconds. | None | None | None |
+| time_zone | string | Yes | None | None | America/Los_Angeles | None |
+| params | object | Yes | None | None | None | None |
+| params.task_id | string | Yes | None | None | None | None |
+| data | object | Yes | None | None | None | None |
+| data.task_id | string | Yes | None | None | None | None |
+| data.task_status | string \| null | Yes | 任务状态快照（用于兼容任务状态枚举）。完成判定请使用 platform_task_status + pending_count / Task status snapshot. Use platform_task_status + pending_count for completion judgment. | None | SUCCEEDED | None |
+| data.platform_task_status | string enum[PENDING, PARTIAL_SUCCEEDED, SUCCEEDED, FAILED] | Yes | 批量条目的平台聚合状态 / Aggregated platform status across all input.file_urls items. | None | PARTIAL_SUCCEEDED | enum[PENDING, PARTIAL_SUCCEEDED, SUCCEEDED, FAILED] |
+| data.is_fully_succeeded | boolean | Yes | 仅当全部条目成功且 pending_count=0 时为 true / True only when all items succeed and pending_count is 0. | None | None | None |
+| data.submit_time | string | No | None | None | None | None |
+| data.scheduled_time | string | No | None | None | None | None |
+| data.end_time | string | No | None | None | None | None |
+| data.task_metrics | object | No | None | None | None | None |
+| data.duration_sec | integer | Yes | 计费总时长（仅统计成功条目，单位秒）/ Billable total duration in seconds from succeeded items only. | None | None | None |
+| data.input_count | integer | Yes | None | None | None | None |
+| data.succeeded_count | integer | Yes | None | None | None | None |
+| data.failed_count | integer | Yes | None | None | None | None |
+| data.pending_count | integer | Yes | None | None | None | None |
+| data.items | array<object> | Yes | 条目级状态列表，按 item_index 对齐 input.file_urls 顺序 / Per-item status aligned with input.file_urls order by item_index. | None | None | None |
+| data.items[] | object | Yes | None | None | None | None |
+| data.items[].item_index | integer | Yes | None | None | None | None |
+| data.items[].task_status | string \| null | Yes | None | None | None | None |
+| data.items[].transcription_url | string \| null(uri) | No | None | None | None | None |
+| data.items[].duration_sec | integer \| null | No | None | None | None | None |
+| data.items[].error_code | string \| null | No | None | None | None | None |
+| data.items[].error_message | string \| null | No | None | None | None | None |
+| data.sentences | array<object> | No | 仅在 platform_task_status=SUCCEEDED 时返回 / Returned only when platform_task_status is SUCCEEDED. | None | None | None |
+| data.sentences[] | object | Yes | None | None | None | None |
+| data.sentences[].sentence_id | integer | Yes | None | None | None | None |
+| data.sentences[].text | string | Yes | None | None | None | None |
+| data.full_text | string | No | 仅在 platform_task_status=SUCCEEDED 时返回 / Returned only when platform_task_status is SUCCEEDED. | None | None | None |
+| code | integer | Yes | None | None | 200 | None |
+| request_id | string | Yes | None | None | None | None |
+| message | string | Yes | None | None | Request successful | None |
+| message_zh | string | Yes | None | None | 请求成功 | None |
+| router | string | Yes | None | None | None | None |