@tikomni/skills 0.1.2 → 0.1.4

package/skills/meta-capability/scripts/test_auth.py

@@ -1,98 +0,0 @@
-#!/usr/bin/env python3
-
-if __package__ in {None, ""}:
-    import sys
-    from pathlib import Path
-
-    _self = Path(__file__).resolve()
-    for _parent in _self.parents:
-        if (_parent / "scripts" / "core" / "bootstrap_env.py").is_file():
-            sys.path.insert(0, str(_parent))
-            break
-
-"""Test TikOmni auth for meta-capability."""
-
-from scripts.core.bootstrap_env import bootstrap_for_direct_run
-
-bootstrap_for_direct_run(__file__, __package__)
-
-import argparse
-
-from scripts.core.config_loader import load_tikomni_config, resolve_runtime_settings
-from scripts.core.tikomni_common import call_json_api, resolve_runtime, write_json_stdout
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(description="Test TikOmni Authorization for meta-capability")
-    parser.add_argument(
-        "--path",
-        default="/api/u1/v1/health/check",
-        help="Health-check route path. Default: /api/u1/v1/health/check",
-    )
-    parser.add_argument("--config", default=None, help="Optional YAML config path")
-    parser.add_argument("--env-file", default=None, help="Optional env file path under skills root")
-    parser.add_argument("--api-key-env", default=None, help="Optional API key env variable name override")
-    parser.add_argument("--base-url", default=None, help="Optional TikOmni API base URL override")
-    parser.add_argument("--timeout-ms", type=int, default=None, help="Optional timeout override in milliseconds")
-    parser.add_argument("--allow-process-env", action="store_true", help="Allow process env to override env files")
-    args = parser.parse_args()
-
-    try:
-        config, config_path = load_tikomni_config(
-            cli_config_path=args.config,
-            env_file=args.env_file,
-            allow_process_env=args.allow_process_env,
-        )
-        runtime_settings = resolve_runtime_settings(
-            config=config,
-            cli_base_url=args.base_url,
-            cli_timeout_ms=args.timeout_ms,
-            cli_api_key_env=args.api_key_env,
-        )
-        runtime = resolve_runtime(
-            env_file=args.env_file,
-            api_key_env=runtime_settings["api_key_env"],
-            base_url=runtime_settings["base_url"],
-            timeout_ms=runtime_settings["timeout_ms"],
-            allow_process_env=args.allow_process_env,
-        )
-    except Exception as error:
-        write_json_stdout(
-            {
-                "ok": False,
-                "method": "GET",
-                "path": args.path,
-                "error_reason": str(error),
-                "request_id": None,
-            }
-        )
-        raise SystemExit(2) from error
-
-    result = call_json_api(
-        base_url=runtime["base_url"],
-        path=args.path,
-        token=runtime["token"],
-        method="GET",
-        timeout_ms=runtime["timeout_ms"],
-    )
-
-    write_json_stdout(
-        {
-            "ok": result["ok"],
-            "method": "GET",
-            "path": args.path,
-            "base_url": runtime["base_url"],
-            "status_code": result.get("status_code"),
-            "request_id": result.get("request_id"),
-            "error_reason": result.get("error_reason"),
-            "auth_env_key": runtime_settings["api_key_env"],
-            "config_path": config_path,
-            "env_bootstrap": runtime.get("env_bootstrap", {}),
-            "data": result.get("data", {}),
-        }
-    )
-    raise SystemExit(0 if result["ok"] else 1)
-
-
-if __name__ == "__main__":
-    main()

package/skills/single-work-analysis/SKILL.md

@@ -1,62 +0,0 @@
----
-name: single-work-analysis
-description: Use this skill for single-item content retrieval, extraction, transcription, benchmarking, breakdown, and analysis. Trigger when the user asks to extract / fetch / transcribe / analyze / benchmark / break down, or 抓取 / 提取 / 转写 / 分析 / 对标 / 拆解 / 作品卡, and the target is a single video, post, article, note, image post, or other single content item rather than a creator, profile, or content collection.
----
-
-# Single Work Analysis
-
-## When To Use
-
-- Use this skill when the target is one concrete content item rather than a creator, account, or profile page.
-- Use this skill when the user wants a work card, subtitles or transcription, structured fields, or single-item analysis.
-- Use this skill for a single video, post, article, note, image post, or another single content object.
-- Use this skill when the user provides a link, share URL, page URL, platform ID, or another clear single-item entry point.
-
-## What It Can Do
-
-- Fetch and normalize facts for one content item.
-- Extract titles, captions, subtitles, transcripts, media URLs, author identifiers, and engagement metrics when available.
-- Produce a standard work card.
-- Return single-item analysis grounded in retrieved facts.
-- Return a reduced but still usable result when some fields are unavailable.
-
-## Core Rules
-
-- Keep the task scoped to one content item.
-- Reuse the unified work-card field dictionary for final fact fields.
-- Prefer the platform guide first. Only go back to API discovery references when the guide is insufficient.
-- For video content, prefer platform-native subtitles before ASR.
-- Use `asr_clean` as the primary text for video items and `caption_raw` as the primary text for text items.
-- If usable `asr_raw` cannot be obtained for a video item, keep the fact card and return `incomplete` instead of fabricating analysis.
-
-## Do Not
-
-- Do not output creator cards.
-- Do not introduce bucketing, sampling, sampled explanations, or `author_analysis_v2`.
-- Do not expose platform process fields directly in the final work-card body.
-- Do not expand a single-item task into creator-level analysis.
-
-## Workflow
-
-1. Identify the platform and `work_modality`, and confirm that the task is about one content item.
-2. Read `references/contracts/work-card-fields.md` to confirm required fields and final display fields.
-3. Read the platform guide first:
-   - Douyin: `references/platform-guides/douyin.md`
-   - Xiaohongshu: `references/platform-guides/xiaohongshu.md`
-   - Other platforms: `references/platform-guides/generic.md`
-4. For video content, read `references/service-guides/asr-u2-u3-fallback.md` and then `references/asr-and-fallback.md` to handle `subtitle_raw`, `asr_raw`, and `asr_clean`.
-5. Read `references/api-capability-index.md`, `references/api-tags/`, and `references/api-contracts/` only when the platform guide does not provide enough route or field detail.
-6. Return the standard work card first, then return the single-item analysis result.
-
-## References
-
-- API capability index: `references/api-capability-index.md`
-- Tag-level route summaries: `references/api-tags/`
-- Tag-level full contracts: `references/api-contracts/`
-- U2/U3 ASR fallback: `references/service-guides/asr-u2-u3-fallback.md`
-- Work-card fields: `references/contracts/work-card-fields.md`
-- Work-card schema: `references/schemas/work-card.schema.json`
-- ASR and failure handling: `references/asr-and-fallback.md`
-- Generic platform guide: `references/platform-guides/generic.md`
-- Douyin guide: `references/platform-guides/douyin.md`
-- Xiaohongshu guide: `references/platform-guides/xiaohongshu.md`

package/skills/single-work-analysis/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "Single Work Analysis"
-  short_description: "Single-item extraction, transcription, and benchmark analysis"
-  default_prompt: "Use $single-work-analysis to handle one concrete content item and return the work card, transcript or subtitles, and single-item analysis, benchmark, or breakdown."

package/skills/single-work-analysis/env.example

@@ -1,36 +0,0 @@
-# [ZH] 本文件是 single-work-analysis 的环境变量示例。
-# [EN] This file is the env example for single-work-analysis.
-#
-# [ZH] 正常情况下，请先把仓库根 env.example 复制到 skills/.env。
-# [EN] In normal use, copy the repo-root env.example to skills/.env first.
-#
-# [ZH] 只有当 single-work-analysis 需要局部覆盖时，才把下面字段复制到本目录的 .env.local。
-# [EN] Only copy selected keys into this folder's .env.local when single-work-analysis needs local overrides.
-
-# [ZH] 输出根目录。默认值：继承 skills/.env；如需局部覆盖，必须是绝对路径。
-# [EN] Output root. Default: inherited from skills/.env; must be absolute when overridden locally.
-# TIKOMNI_OUTPUT_ROOT="/absolute/path/to/tikomni-output"
-
-# [ZH] 卡片根目录。默认值：继承 skills/.env；如需局部覆盖，必须是绝对路径。
-# [EN] Card root. Default: inherited from skills/.env; must be absolute when overridden locally.
-# TIKOMNI_CARD_ROOT="/absolute/path/to/tikomni-cards"
-
-# [ZH] 路由语言预设。默认值：zh
-# [EN] Route locale preset. Default: zh
-TIKOMNI_PATH_LOCALE="zh"
-
-# [ZH] 作品卡文件名前缀。默认值：CBV
-# [EN] Work card filename prefix. Default: CBV
-TIKOMNI_CARD_PREFIX_WORK="CBV"
-
-# [ZH] 卡片文件名模板。默认值：{prefix}-{author_slug}-{title_slug}{ext}
-# [EN] Card filename pattern. Default: {prefix}-{author_slug}-{title_slug}{ext}
-TIKOMNI_FILENAME_PATTERN_CARD="{prefix}-{author_slug}-{title_slug}{ext}"
-
-# [ZH] JSON 文件名模板。默认值：{timestamp}-{platform}-{identifier}{ext}
-# [EN] JSON filename pattern. Default: {timestamp}-{platform}-{identifier}{ext}
-TIKOMNI_FILENAME_PATTERN_JSON="{timestamp}-{platform}-{identifier}{ext}"
-
-# [ZH] 显式配置文件路径。默认值：空；留空时自动使用本模块 defaults.yaml
-# [EN] Explicit config file path. Default: empty; when empty the module uses its own defaults.yaml
-# TIKOMNI_CONFIG_FILE=""

package/skills/single-work-analysis/references/api-capability-index.md

@@ -1,92 +0,0 @@
-# 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/single-work-analysis/references/api-contracts/asr-api.md

@@ -1,130 +0,0 @@
-# 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 |