@tikomni/skills 0.1.0

package/lib/installer.js

@@ -0,0 +1,176 @@
+"use strict";
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+const PACKAGE_ROOT = path.resolve(__dirname, "..");
+const SKILLS_ROOT = path.join(PACKAGE_ROOT, "skills");
+const ALLOWLIST_FILE = path.join(PACKAGE_ROOT, ".skill-package-allowlist.txt");
+const ROOT_ENV_EXAMPLE = path.join(PACKAGE_ROOT, "env.example");
+const RUNTIME_ALIASES = {
+  claude: "claude-code",
+  "claude-code": "claude-code",
+  codex: "codex",
+  openclaw: "openclaw"
+};
+
+function listAvailableSkills() {
+  const allowlistEntries = loadAllowlistEntries();
+  if (allowlistEntries.length > 0) {
+    return allowlistEntries
+      .map((entry) => {
+        const absolutePath = path.join(PACKAGE_ROOT, entry);
+        return {
+          name: path.basename(entry),
+          relativePath: entry,
+          absolutePath
+        };
+      })
+      .filter((entry) => fs.existsSync(path.join(entry.absolutePath, "SKILL.md")));
+  }
+
+  return fs
+    .readdirSync(SKILLS_ROOT, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => ({
+      name: entry.name,
+      relativePath: path.join("skills", entry.name),
+      absolutePath: path.join(SKILLS_ROOT, entry.name)
+    }))
+    .filter((entry) => fs.existsSync(path.join(entry.absolutePath, "SKILL.md")));
+}
+
+function loadAllowlistEntries() {
+  if (!fs.existsSync(ALLOWLIST_FILE)) {
+    return [];
+  }
+
+  return fs
+    .readFileSync(ALLOWLIST_FILE, "utf8")
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter((line) => line && !line.startsWith("#") && line.startsWith("skills/"));
+}
+
+function normalizeRuntime(runtime) {
+  const normalized = RUNTIME_ALIASES[String(runtime || "").trim().toLowerCase()];
+  if (!normalized) {
+    throw new Error(`不支持的运行时: ${runtime}`);
+  }
+  return normalized;
+}
+
+function resolveRuntimeDestination(runtime, explicitDir) {
+  if (explicitDir) {
+    return path.resolve(explicitDir);
+  }
+
+  const normalizedRuntime = normalizeRuntime(runtime);
+  if (normalizedRuntime === "codex") {
+    const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
+    return path.join(codexHome, "skills");
+  }
+
+  if (normalizedRuntime === "claude-code") {
+    if (process.env.CLAUDE_SKILLS_DIR) {
+      return path.resolve(process.env.CLAUDE_SKILLS_DIR);
+    }
+
+    const claudeHome =
+      process.env.CLAUDE_CODE_HOME ||
+      process.env.CLAUDE_HOME ||
+      path.join(os.homedir(), ".claude");
+    return path.join(claudeHome, "skills");
+  }
+
+  if (process.env.OPENCLAW_SKILLS_DIR) {
+    return path.resolve(process.env.OPENCLAW_SKILLS_DIR);
+  }
+
+  if (process.env.OPENCLAW_HOME) {
+    return pickExistingOrDefault([
+      path.join(process.env.OPENCLAW_HOME, "workspace", "skills"),
+      path.join(process.env.OPENCLAW_HOME, "skills")
+    ]);
+  }
+
+  return pickExistingOrDefault([
+    path.join(os.homedir(), ".openclaw", "workspace", "skills"),
+    path.join(os.homedir(), ".openclaw", "skills")
+  ]);
+}
+
+function pickExistingOrDefault(candidates) {
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return candidates[0];
+}
+
+function resolveSkillSelection(skillNames) {
+  const requested = skillNames.length === 0 ? ["all"] : skillNames;
+  const availableSkills = listAvailableSkills();
+  const byName = new Map(availableSkills.map((skill) => [skill.name, skill]));
+
+  if (requested.includes("all")) {
+    return availableSkills;
+  }
+
+  return requested.map((name) => {
+    const skill = byName.get(name);
+    if (!skill) {
+      const candidates = availableSkills.map((entry) => entry.name).join(", ");
+      throw new Error(`未知 skill: ${name}；可选值: ${candidates}`);
+    }
+    return skill;
+  });
+}
+
+function installSkills(options) {
+  const runtime = normalizeRuntime(options.runtime);
+  const destinationRoot = resolveRuntimeDestination(runtime, options.explicitDir);
+  const selectedSkills = resolveSkillSelection(options.skillNames || []);
+  const force = Boolean(options.force);
+
+  fs.mkdirSync(destinationRoot, { recursive: true });
+
+  const installed = [];
+  for (const skill of selectedSkills) {
+    const targetPath = path.join(destinationRoot, skill.name);
+    if (fs.existsSync(targetPath)) {
+      if (!force) {
+        throw new Error(`目标目录已存在: ${targetPath}；如需覆盖请加 --force`);
+      }
+      fs.rmSync(targetPath, { recursive: true, force: true });
+    }
+
+    fs.cpSync(skill.absolutePath, targetPath, { recursive: true });
+    installed.push({
+      name: skill.name,
+      sourcePath: skill.absolutePath,
+      targetPath
+    });
+  }
+
+  const sharedEnvTargetPath = path.join(destinationRoot, "env.example");
+  if (fs.existsSync(ROOT_ENV_EXAMPLE) && (force || !fs.existsSync(sharedEnvTargetPath))) {
+    fs.copyFileSync(ROOT_ENV_EXAMPLE, sharedEnvTargetPath);
+  }
+
+  return {
+    runtime,
+    destinationRoot,
+    installed
+  };
+}
+
+module.exports = {
+  installSkills,
+  listAvailableSkills,
+  normalizeRuntime,
+  resolveRuntimeDestination,
+  resolveSkillSelection
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@tikomni/skills",
+  "version": "0.1.0",
+  "description": "TikOmni skill installer CLI for Codex, Claude Code, and OpenClaw",
+  "license": "MIT",
+  "homepage": "https://github.com/mark-ly-wang/TikOmni-Skills#readme",
+  "bugs": {
+    "url": "https://github.com/mark-ly-wang/TikOmni-Skills/issues"
+  },
+  "bin": {
+    "tikomni-skills": "./bin/tikomni-skills.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "skills/",
+    ".skill-package-allowlist.txt",
+    "env.example",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test",
+    "pack:dry-run": "npm pack --dry-run"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "tikomni",
+    "skills",
+    "codex",
+    "claude-code",
+    "openclaw",
+    "installer"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark-ly-wang/TikOmni-Skills.git"
+  }
+}

package/skills/creator-analysis/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: creator-analysis
+description: Use this skill for creator, account profile, and content-collection retrieval, benchmarking, breakdown, and analysis. Trigger when the user asks to analyze creator / analyze account / profile analysis / creator benchmark / creator breakdown, or 创作者分析 / 账号分析 / 主页分析 / 博主分析 / 博主对标 / 账号拆解 / 作者卡 / 主页作品汇总, and the target is a creator, account profile, channel, or content collection rather than one content item.
+---
+
+# Creator Analysis
+
+## When To Use
+
+- Use this skill when the target is a creator, account, profile page, channel, or content collection rather than a single content item.
+- Use this skill when the user wants a creator card, a full set of work cards, sampled explanations, or aggregated creator-level conclusions.
+- Use this skill when multiple videos under one profile should go through batch ASR first.
+- Use this skill when the user provides a profile URL, creator handle, account identifier, channel entry, or another creator-level entry point.
+
+## What It Can Do
+
+- Fetch and normalize creator-side fact fields.
+- Fetch and normalize the full content collection under a profile.
+- Produce work fact cards for the retrieved items.
+- Run batch ASR for video items when needed.
+- Complete bucketing, sampling, sampled explanations, and creator-level analysis.
+- Return creator cards, work cards, and aggregated conclusions.
+
+## Core Rules
+
+- Keep the task scoped to a creator, account profile, or content collection.
+- Prefer the platform guide first. Only go back to API discovery references when the guide is insufficient.
+- Keep fact cards for all retrieved works, but do not run per-work deep LLM analysis.
+- Prefer batch ASR for video items, with up to 100 links per batch.
+- Let sampled-work explanation fields come from one batch LLM step only.
+- Treat `author_analysis_v2` as the formal creator-level analysis object.
+- If `analysis_eligibility=incomplete`, keep the fact card but exclude the item from sampling, sampled explanations, and creator-level analysis.
+
+## Do Not
+
+- Do not paste sampled explanations directly into every work-card body.
+- Do not expose platform process fields directly in the final card body.
+- Do not introduce per-work LLM explanations inside the creator path.
+- Do not collapse a creator task into single-item analysis when the user clearly wants creator-level output.
+
+## Workflow
+
+1. Identify the platform and confirm that the target is a creator, account profile, channel, or content collection.
+2. Read `references/contracts/creator-card-fields.md` to confirm required creator-card fields.
+3. Read `references/contracts/work-card-fields.md` to confirm required work-card fields for the collected items.
+4. Read the platform guide first:
+   - Douyin: `references/platform-guides/douyin.md`
+   - Xiaohongshu: `references/platform-guides/xiaohongshu.md`
+   - Other platforms: `references/platform-guides/generic.md`
+5. If video items are involved, read `references/service-guides/asr-u2-u3-fallback.md` and then `references/asr-orchestration.md` to run batch ASR and fallback.
+6. 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.
+7. Read `references/workflow.md` to complete bucketing, sampling, sampled explanations, and `author_analysis_v2`.
+8. Return the creator card, work cards, and aggregated conclusions.
+
+## 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`
+- Creator-card fields: `references/contracts/creator-card-fields.md`
+- Work-card fields: `references/contracts/work-card-fields.md`
+- ASR orchestration: `references/asr-orchestration.md`
+- Creator workflow: `references/workflow.md`
+- Author-analysis prompt contract: `references/prompt-contracts/author-analysis-v2.md`
+- Sampled-explanations prompt contract: `references/prompt-contracts/sampled-work-batch-explanations.md`
+- Author-analysis schema: `references/schemas/author-analysis-v2.schema.json`
+- Sampled-explanations schema: `references/schemas/sampled-work-batch-explanations.schema.json`
+- Generic platform guide: `references/platform-guides/generic.md`
+- Douyin guide: `references/platform-guides/douyin.md`
+- Xiaohongshu guide: `references/platform-guides/xiaohongshu.md`

package/skills/creator-analysis/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Creator Analysis"
+  short_description: "Creator, profile, and collection benchmark analysis"
+  default_prompt: "Use $creator-analysis to analyze a creator, account profile, or content collection and return the creator card, work cards, creator benchmark breakdown, and aggregated conclusions."

package/skills/creator-analysis/env.example

@@ -0,0 +1,36 @@
+# [ZH] 本文件是 creator-analysis 的环境变量示例。
+# [EN] This file is the env example for creator-analysis.
+#
+# [ZH] 正常情况下，请先把仓库根 env.example 复制到 skills/.env。
+# [EN] In normal use, copy the repo-root env.example to skills/.env first.
+#
+# [ZH] 只有当 creator-analysis 需要局部覆盖时，才把下面字段复制到本目录的 .env.local。
+# [EN] Only copy selected keys into this folder's .env.local when creator-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] 作者级 LLM 分析超时，单位秒。默认值：45
+# [EN] Timeout for creator-level LLM analysis in seconds. Default: 45
+TIKOMNI_AUTHOR_ANALYSIS_TIMEOUT_SEC="45"
+
+# [ZH] sampled works 少于该阈值时跳过作者级 LLM 分析。默认值：5
+# [EN] Skip creator-level LLM analysis when sampled works are below this threshold. Default: 5
+TIKOMNI_AUTHOR_ANALYSIS_SMALL_SAMPLE_SKIP="5"
+
+# [ZH] sampled works 批量解释超时，单位秒。默认值：45
+# [EN] Timeout for sampled-work batch explanations in seconds. Default: 45
+TIKOMNI_SAMPLED_EXPLANATION_TIMEOUT_SEC="45"
+
+# [ZH] 显式配置文件路径。默认值：空；留空时自动使用本模块 defaults.yaml
+# [EN] Explicit config file path. Default: empty; when empty the module uses its own defaults.yaml
+# TIKOMNI_CONFIG_FILE=""

package/skills/creator-analysis/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/creator-analysis/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 |