@tikomni/skills 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (474) hide show
  1. package/.skill-package-allowlist.txt +1 -3
  2. package/README.md +41 -49
  3. package/README.zh-CN.md +43 -51
  4. package/bin/tikomni-skills.js +2 -2
  5. package/env.example +37 -56
  6. package/package.json +7 -5
  7. package/skills/social-media-crawl/SKILL.md +53 -0
  8. package/skills/social-media-crawl/agents/openai.yaml +5 -0
  9. package/skills/social-media-crawl/references/contracts/output-envelope.md +22 -0
  10. package/skills/social-media-crawl/references/contracts/work-fact-card-fields.md +48 -0
  11. package/skills/social-media-crawl/references/guides/generic-mcp-objects.md +30 -0
  12. package/skills/social-media-crawl/references/mcp-usage-contract.md +30 -0
  13. package/skills/social-media-crawl/references/pipelines/douyin-creator-home.md +7 -0
  14. package/skills/social-media-crawl/references/pipelines/douyin-single-work.md +7 -0
  15. package/skills/social-media-crawl/references/pipelines/xiaohongshu-creator-home.md +7 -0
  16. package/skills/social-media-crawl/references/pipelines/xiaohongshu-single-work.md +7 -0
  17. package/skills/social-media-crawl/references/schemas/creator-profile.schema.json +33 -0
  18. package/skills/social-media-crawl/references/schemas/output-envelope.schema.json +41 -0
  19. package/skills/social-media-crawl/references/schemas/work-collection.schema.json +29 -0
  20. package/skills/social-media-crawl/references/schemas/work-fact-card.schema.json +67 -0
  21. package/skills/social-media-crawl/references/service-guides/u2-u3-mandatory-fallback.md +21 -0
  22. package/skills/social-media-crawl/scripts/__init__.py +2 -0
  23. package/skills/social-media-crawl/scripts/core/__init__.py +2 -0
  24. package/skills/{single-work-analysis/scripts/pipeline/asr → social-media-crawl/scripts/core}/asr_pipeline.py +98 -2
  25. package/skills/social-media-crawl/scripts/core/completeness.py +83 -0
  26. package/skills/{single-work-analysis → social-media-crawl}/scripts/core/config_loader.py +106 -141
  27. package/skills/social-media-crawl/scripts/core/mcp_dispatch.py +145 -0
  28. package/skills/social-media-crawl/scripts/core/object_detection.py +63 -0
  29. package/skills/{single-work-analysis/scripts/pipeline/asr → social-media-crawl/scripts/core}/poll_u2_task.py +3 -1
  30. package/skills/{creator-analysis → social-media-crawl}/scripts/core/progress_report.py +32 -0
  31. package/skills/social-media-crawl/scripts/core/storage_router.py +160 -0
  32. package/skills/social-media-crawl/scripts/core/u3_fallback.py +328 -0
  33. package/skills/social-media-crawl/scripts/pipelines/__init__.py +2 -0
  34. package/skills/social-media-crawl/scripts/pipelines/douyin_creator_home_helpers.py +35 -0
  35. package/skills/social-media-crawl/scripts/pipelines/douyin_platform_adapter.py +7 -0
  36. package/skills/{creator-analysis/scripts/author_home/asr → social-media-crawl/scripts/pipelines}/home_asr.py +1 -1
  37. package/skills/{creator-analysis/scripts/author_home/adapters → social-media-crawl/scripts/pipelines}/platform_adapters.py +8 -2
  38. package/skills/social-media-crawl/scripts/pipelines/run_douyin_creator_home.py +237 -0
  39. package/skills/{single-work-analysis/scripts/platform/douyin/run_douyin_single_video.py → social-media-crawl/scripts/pipelines/run_douyin_single_work.py} +58 -149
  40. package/skills/social-media-crawl/scripts/pipelines/run_xiaohongshu_creator_home.py +237 -0
  41. package/skills/{single-work-analysis/scripts/platform/xiaohongshu/run_xiaohongshu_extract.py → social-media-crawl/scripts/pipelines/run_xiaohongshu_single_work.py} +30 -119
  42. package/skills/{creator-analysis/scripts/author_home → social-media-crawl/scripts/pipelines}/schema.py +1 -1
  43. package/skills/social-media-crawl/scripts/pipelines/xiaohongshu_creator_home_helpers.py +35 -0
  44. package/skills/social-media-crawl/scripts/pipelines/xiaohongshu_platform_adapter.py +7 -0
  45. package/skills/social-media-crawl/scripts/writers/__init__.py +1 -0
  46. package/skills/social-media-crawl/scripts/writers/write_work_fact_card.py +391 -0
  47. package/skills/creator-analysis/SKILL.md +0 -95
  48. package/skills/creator-analysis/agents/openai.yaml +0 -4
  49. package/skills/creator-analysis/env.example +0 -36
  50. package/skills/creator-analysis/references/api-capability-index.md +0 -92
  51. package/skills/creator-analysis/references/api-contracts/asr-api.md +0 -130
  52. package/skills/creator-analysis/references/api-contracts/bilibili-app-api.md +0 -776
  53. package/skills/creator-analysis/references/api-contracts/bilibili-web-api.md +0 -2017
  54. package/skills/creator-analysis/references/api-contracts/demo-api.md +0 -717
  55. package/skills/creator-analysis/references/api-contracts/douyin-app-v3-api.md +0 -3594
  56. package/skills/creator-analysis/references/api-contracts/douyin-billboard-api.md +0 -2274
  57. package/skills/creator-analysis/references/api-contracts/douyin-creator-api.md +0 -1575
  58. package/skills/creator-analysis/references/api-contracts/douyin-creator-v2-api.md +0 -3254
  59. package/skills/creator-analysis/references/api-contracts/douyin-search-api.md +0 -4118
  60. package/skills/creator-analysis/references/api-contracts/douyin-web-api.md +0 -5544
  61. package/skills/creator-analysis/references/api-contracts/douyin-xingtu-api.md +0 -1916
  62. package/skills/creator-analysis/references/api-contracts/douyin-xingtu-v2-api.md +0 -1540
  63. package/skills/creator-analysis/references/api-contracts/health-check.md +0 -69
  64. package/skills/creator-analysis/references/api-contracts/hybrid-parsing.md +0 -78
  65. package/skills/creator-analysis/references/api-contracts/instagram-v1-api.md +0 -2256
  66. package/skills/creator-analysis/references/api-contracts/instagram-v2-api.md +0 -2011
  67. package/skills/creator-analysis/references/api-contracts/instagram-v3-api.md +0 -2630
  68. package/skills/creator-analysis/references/api-contracts/ios-shortcut.md +0 -44
  69. package/skills/creator-analysis/references/api-contracts/kuaishou-app-api.md +0 -1518
  70. package/skills/creator-analysis/references/api-contracts/kuaishou-web-api.md +0 -1242
  71. package/skills/creator-analysis/references/api-contracts/lemon8-app-api.md +0 -1088
  72. package/skills/creator-analysis/references/api-contracts/linkedin-web-api.md +0 -1949
  73. package/skills/creator-analysis/references/api-contracts/media-ingest-api.md +0 -126
  74. package/skills/creator-analysis/references/api-contracts/pipixia-app-api.md +0 -1142
  75. package/skills/creator-analysis/references/api-contracts/reddit-app-api.md +0 -2025
  76. package/skills/creator-analysis/references/api-contracts/sora2-api.md +0 -2266
  77. package/skills/creator-analysis/references/api-contracts/temp-mail-api.md +0 -208
  78. package/skills/creator-analysis/references/api-contracts/threads-web-api.md +0 -897
  79. package/skills/creator-analysis/references/api-contracts/tikhub-downloader-api.md +0 -134
  80. package/skills/creator-analysis/references/api-contracts/tikhub-user-api.md +0 -494
  81. package/skills/creator-analysis/references/api-contracts/tiktok-ads-api.md +0 -5947
  82. package/skills/creator-analysis/references/api-contracts/tiktok-analytics-api.md +0 -968
  83. package/skills/creator-analysis/references/api-contracts/tiktok-app-v3-api.md +0 -5735
  84. package/skills/creator-analysis/references/api-contracts/tiktok-creator-api.md +0 -1951
  85. package/skills/creator-analysis/references/api-contracts/tiktok-interaction-api.md +0 -742
  86. package/skills/creator-analysis/references/api-contracts/tiktok-shop-web-api.md +0 -1890
  87. package/skills/creator-analysis/references/api-contracts/tiktok-web-api.md +0 -4448
  88. package/skills/creator-analysis/references/api-contracts/toutiao-app-api.md +0 -342
  89. package/skills/creator-analysis/references/api-contracts/toutiao-web-api.md +0 -143
  90. package/skills/creator-analysis/references/api-contracts/twitter-web-api.md +0 -989
  91. package/skills/creator-analysis/references/api-contracts/wechat-channels-api.md +0 -809
  92. package/skills/creator-analysis/references/api-contracts/wechat-media-platform-web-api.md +0 -677
  93. package/skills/creator-analysis/references/api-contracts/weibo-app-api.md +0 -1547
  94. package/skills/creator-analysis/references/api-contracts/weibo-web-api.md +0 -798
  95. package/skills/creator-analysis/references/api-contracts/weibo-web-v2-api.md +0 -2459
  96. package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-api.md +0 -1291
  97. package/skills/creator-analysis/references/api-contracts/xiaohongshu-app-v2-api.md +0 -1683
  98. package/skills/creator-analysis/references/api-contracts/xiaohongshu-web-api.md +0 -1324
  99. package/skills/creator-analysis/references/api-contracts/xiaohongshu-web-v2-api.md +0 -1209
  100. package/skills/creator-analysis/references/api-contracts/xigua-app-v2-api.md +0 -489
  101. package/skills/creator-analysis/references/api-contracts/youtube-web-api.md +0 -2636
  102. package/skills/creator-analysis/references/api-contracts/youtube-web-v2-api.md +0 -2660
  103. package/skills/creator-analysis/references/api-contracts/zhihu-web-api.md +0 -2315
  104. package/skills/creator-analysis/references/api-tags/asr-api.md +0 -100
  105. package/skills/creator-analysis/references/api-tags/bilibili-app-api.md +0 -482
  106. package/skills/creator-analysis/references/api-tags/bilibili-web-api.md +0 -1267
  107. package/skills/creator-analysis/references/api-tags/demo-api.md +0 -365
  108. package/skills/creator-analysis/references/api-tags/douyin-app-v3-api.md +0 -2012
  109. package/skills/creator-analysis/references/api-tags/douyin-billboard-api.md +0 -1428
  110. package/skills/creator-analysis/references/api-tags/douyin-creator-api.md +0 -694
  111. package/skills/creator-analysis/references/api-tags/douyin-creator-v2-api.md +0 -694
  112. package/skills/creator-analysis/references/api-tags/douyin-search-api.md +0 -1059
  113. package/skills/creator-analysis/references/api-tags/douyin-web-api.md +0 -3314
  114. package/skills/creator-analysis/references/api-tags/douyin-xingtu-api.md +0 -935
  115. package/skills/creator-analysis/references/api-tags/douyin-xingtu-v2-api.md +0 -925
  116. package/skills/creator-analysis/references/api-tags/health-check.md +0 -40
  117. package/skills/creator-analysis/references/api-tags/hybrid-parsing.md +0 -57
  118. package/skills/creator-analysis/references/api-tags/instagram-v1-api.md +0 -1224
  119. package/skills/creator-analysis/references/api-tags/instagram-v2-api.md +0 -1147
  120. package/skills/creator-analysis/references/api-tags/instagram-v3-api.md +0 -1123
  121. package/skills/creator-analysis/references/api-tags/ios-shortcut.md +0 -45
  122. package/skills/creator-analysis/references/api-tags/kuaishou-app-api.md +0 -846
  123. package/skills/creator-analysis/references/api-tags/kuaishou-web-api.md +0 -551
  124. package/skills/creator-analysis/references/api-tags/lemon8-app-api.md +0 -687
  125. package/skills/creator-analysis/references/api-tags/linkedin-web-api.md +0 -1105
  126. package/skills/creator-analysis/references/api-tags/media-ingest-api.md +0 -112
  127. package/skills/creator-analysis/references/api-tags/pipixia-app-api.md +0 -721
  128. package/skills/creator-analysis/references/api-tags/reddit-app-api.md +0 -1057
  129. package/skills/creator-analysis/references/api-tags/sora2-api.md +0 -737
  130. package/skills/creator-analysis/references/api-tags/temp-mail-api.md +0 -136
  131. package/skills/creator-analysis/references/api-tags/threads-web-api.md +0 -472
  132. package/skills/creator-analysis/references/api-tags/tikhub-downloader-api.md +0 -65
  133. package/skills/creator-analysis/references/api-tags/tikhub-user-api.md +0 -253
  134. package/skills/creator-analysis/references/api-tags/tiktok-ads-api.md +0 -1393
  135. package/skills/creator-analysis/references/api-tags/tiktok-analytics-api.md +0 -179
  136. package/skills/creator-analysis/references/api-tags/tiktok-app-v3-api.md +0 -3264
  137. package/skills/creator-analysis/references/api-tags/tiktok-creator-api.md +0 -709
  138. package/skills/creator-analysis/references/api-tags/tiktok-interaction-api.md +0 -366
  139. package/skills/creator-analysis/references/api-tags/tiktok-shop-web-api.md +0 -663
  140. package/skills/creator-analysis/references/api-tags/tiktok-web-api.md +0 -2516
  141. package/skills/creator-analysis/references/api-tags/toutiao-app-api.md +0 -220
  142. package/skills/creator-analysis/references/api-tags/toutiao-web-api.md +0 -96
  143. package/skills/creator-analysis/references/api-tags/twitter-web-api.md +0 -562
  144. package/skills/creator-analysis/references/api-tags/wechat-channels-api.md +0 -405
  145. package/skills/creator-analysis/references/api-tags/wechat-media-platform-web-api.md +0 -431
  146. package/skills/creator-analysis/references/api-tags/weibo-app-api.md +0 -851
  147. package/skills/creator-analysis/references/api-tags/weibo-web-api.md +0 -470
  148. package/skills/creator-analysis/references/api-tags/weibo-web-v2-api.md +0 -1405
  149. package/skills/creator-analysis/references/api-tags/xiaohongshu-app-api.md +0 -534
  150. package/skills/creator-analysis/references/api-tags/xiaohongshu-app-v2-api.md +0 -934
  151. package/skills/creator-analysis/references/api-tags/xiaohongshu-web-api.md +0 -757
  152. package/skills/creator-analysis/references/api-tags/xiaohongshu-web-v2-api.md +0 -762
  153. package/skills/creator-analysis/references/api-tags/xigua-app-v2-api.md +0 -308
  154. package/skills/creator-analysis/references/api-tags/youtube-web-api.md +0 -934
  155. package/skills/creator-analysis/references/api-tags/youtube-web-v2-api.md +0 -717
  156. package/skills/creator-analysis/references/api-tags/zhihu-web-api.md +0 -1384
  157. package/skills/creator-analysis/references/asr-orchestration.md +0 -33
  158. package/skills/creator-analysis/references/config-templates/defaults.yaml +0 -60
  159. package/skills/creator-analysis/references/contracts/creator-card-fields.md +0 -25
  160. package/skills/creator-analysis/references/contracts/work-card-fields.md +0 -68
  161. package/skills/creator-analysis/references/platform-guides/douyin.md +0 -54
  162. package/skills/creator-analysis/references/platform-guides/generic.md +0 -50
  163. package/skills/creator-analysis/references/platform-guides/xiaohongshu.md +0 -69
  164. package/skills/creator-analysis/references/prompt-contracts/asr-clean.md +0 -28
  165. package/skills/creator-analysis/references/prompt-contracts/author-analysis-v2.md +0 -46
  166. package/skills/creator-analysis/references/prompt-contracts/author-analysis.md +0 -49
  167. package/skills/creator-analysis/references/prompt-contracts/cta.md +0 -24
  168. package/skills/creator-analysis/references/prompt-contracts/hook.md +0 -25
  169. package/skills/creator-analysis/references/prompt-contracts/insight.md +0 -47
  170. package/skills/creator-analysis/references/prompt-contracts/sampled-work-batch-explanations.md +0 -30
  171. package/skills/creator-analysis/references/prompt-contracts/structure.md +0 -25
  172. package/skills/creator-analysis/references/prompt-contracts/style.md +0 -27
  173. package/skills/creator-analysis/references/prompt-contracts/summary.md +0 -29
  174. package/skills/creator-analysis/references/prompt-contracts/topic.md +0 -29
  175. package/skills/creator-analysis/references/schemas/author-analysis-input-v1.schema.json +0 -325
  176. package/skills/creator-analysis/references/schemas/author-analysis-v2.schema.json +0 -287
  177. package/skills/creator-analysis/references/schemas/sampled-work-batch-explanations.schema.json +0 -41
  178. package/skills/creator-analysis/references/service-guides/asr-u2-u3-fallback.md +0 -75
  179. package/skills/creator-analysis/references/workflow.md +0 -23
  180. package/skills/creator-analysis/scripts/__init__.py +0 -0
  181. package/skills/creator-analysis/scripts/author_home/__init__.py +0 -0
  182. package/skills/creator-analysis/scripts/author_home/adapters/__init__.py +0 -0
  183. package/skills/creator-analysis/scripts/author_home/analyzers/__init__.py +0 -0
  184. package/skills/creator-analysis/scripts/author_home/analyzers/author_analysis_v2_support.py +0 -1165
  185. package/skills/creator-analysis/scripts/author_home/analyzers/prompt_first_analyzers.py +0 -447
  186. package/skills/creator-analysis/scripts/author_home/analyzers/sampled_work_batch_explainer.py +0 -331
  187. package/skills/creator-analysis/scripts/author_home/asr/__init__.py +0 -5
  188. package/skills/creator-analysis/scripts/author_home/builders/__init__.py +0 -0
  189. package/skills/creator-analysis/scripts/author_home/builders/home_builders.py +0 -213
  190. package/skills/creator-analysis/scripts/author_home/collectors/__init__.py +0 -0
  191. package/skills/creator-analysis/scripts/author_home/orchestrator/__init__.py +0 -0
  192. package/skills/creator-analysis/scripts/author_home/orchestrator/run_author_analysis.py +0 -834
  193. package/skills/creator-analysis/scripts/author_home/orchestrator/work_analysis_artifacts.py +0 -609
  194. package/skills/creator-analysis/scripts/core/__init__.py +0 -0
  195. package/skills/creator-analysis/scripts/core/analysis_pipeline.py +0 -133
  196. package/skills/creator-analysis/scripts/core/config_loader.py +0 -418
  197. package/skills/creator-analysis/scripts/core/storage_router.py +0 -256
  198. package/skills/creator-analysis/scripts/core/tikomni_common.py +0 -588
  199. package/skills/creator-analysis/scripts/pipeline/__init__.py +0 -0
  200. package/skills/creator-analysis/scripts/pipeline/asr/__init__.py +0 -0
  201. package/skills/creator-analysis/scripts/pipeline/asr/asr_pipeline.py +0 -1189
  202. package/skills/creator-analysis/scripts/pipeline/asr/poll_u2_task.py +0 -95
  203. package/skills/creator-analysis/scripts/platform/__init__.py +0 -0
  204. package/skills/creator-analysis/scripts/platform/douyin/__init__.py +0 -0
  205. package/skills/creator-analysis/scripts/platform/douyin/run_douyin_single_video.py +0 -1208
  206. package/skills/creator-analysis/scripts/platform/xiaohongshu/__init__.py +0 -0
  207. package/skills/creator-analysis/scripts/platform/xiaohongshu/run_xiaohongshu_extract.py +0 -2128
  208. package/skills/creator-analysis/scripts/writers/__init__.py +0 -0
  209. package/skills/creator-analysis/scripts/writers/write_author_homepage_samples.py +0 -107
  210. package/skills/creator-analysis/scripts/writers/write_benchmark_card.py +0 -1579
  211. package/skills/meta-capability/SKILL.md +0 -69
  212. package/skills/meta-capability/agents/openai.yaml +0 -4
  213. package/skills/meta-capability/env.example +0 -42
  214. package/skills/meta-capability/references/api-capability-index.md +0 -92
  215. package/skills/meta-capability/references/api-contracts/asr-api.md +0 -130
  216. package/skills/meta-capability/references/api-contracts/bilibili-app-api.md +0 -776
  217. package/skills/meta-capability/references/api-contracts/bilibili-web-api.md +0 -2017
  218. package/skills/meta-capability/references/api-contracts/demo-api.md +0 -717
  219. package/skills/meta-capability/references/api-contracts/douyin-app-v3-api.md +0 -3594
  220. package/skills/meta-capability/references/api-contracts/douyin-billboard-api.md +0 -2274
  221. package/skills/meta-capability/references/api-contracts/douyin-creator-api.md +0 -1575
  222. package/skills/meta-capability/references/api-contracts/douyin-creator-v2-api.md +0 -3254
  223. package/skills/meta-capability/references/api-contracts/douyin-search-api.md +0 -4118
  224. package/skills/meta-capability/references/api-contracts/douyin-web-api.md +0 -5544
  225. package/skills/meta-capability/references/api-contracts/douyin-xingtu-api.md +0 -1916
  226. package/skills/meta-capability/references/api-contracts/douyin-xingtu-v2-api.md +0 -1540
  227. package/skills/meta-capability/references/api-contracts/health-check.md +0 -69
  228. package/skills/meta-capability/references/api-contracts/hybrid-parsing.md +0 -78
  229. package/skills/meta-capability/references/api-contracts/instagram-v1-api.md +0 -2256
  230. package/skills/meta-capability/references/api-contracts/instagram-v2-api.md +0 -2011
  231. package/skills/meta-capability/references/api-contracts/instagram-v3-api.md +0 -2630
  232. package/skills/meta-capability/references/api-contracts/ios-shortcut.md +0 -44
  233. package/skills/meta-capability/references/api-contracts/kuaishou-app-api.md +0 -1518
  234. package/skills/meta-capability/references/api-contracts/kuaishou-web-api.md +0 -1242
  235. package/skills/meta-capability/references/api-contracts/lemon8-app-api.md +0 -1088
  236. package/skills/meta-capability/references/api-contracts/linkedin-web-api.md +0 -1949
  237. package/skills/meta-capability/references/api-contracts/media-ingest-api.md +0 -126
  238. package/skills/meta-capability/references/api-contracts/pipixia-app-api.md +0 -1142
  239. package/skills/meta-capability/references/api-contracts/reddit-app-api.md +0 -2025
  240. package/skills/meta-capability/references/api-contracts/sora2-api.md +0 -2266
  241. package/skills/meta-capability/references/api-contracts/temp-mail-api.md +0 -208
  242. package/skills/meta-capability/references/api-contracts/threads-web-api.md +0 -897
  243. package/skills/meta-capability/references/api-contracts/tikhub-downloader-api.md +0 -134
  244. package/skills/meta-capability/references/api-contracts/tikhub-user-api.md +0 -494
  245. package/skills/meta-capability/references/api-contracts/tiktok-ads-api.md +0 -5947
  246. package/skills/meta-capability/references/api-contracts/tiktok-analytics-api.md +0 -968
  247. package/skills/meta-capability/references/api-contracts/tiktok-app-v3-api.md +0 -5735
  248. package/skills/meta-capability/references/api-contracts/tiktok-creator-api.md +0 -1951
  249. package/skills/meta-capability/references/api-contracts/tiktok-interaction-api.md +0 -742
  250. package/skills/meta-capability/references/api-contracts/tiktok-shop-web-api.md +0 -1890
  251. package/skills/meta-capability/references/api-contracts/tiktok-web-api.md +0 -4448
  252. package/skills/meta-capability/references/api-contracts/toutiao-app-api.md +0 -342
  253. package/skills/meta-capability/references/api-contracts/toutiao-web-api.md +0 -143
  254. package/skills/meta-capability/references/api-contracts/twitter-web-api.md +0 -989
  255. package/skills/meta-capability/references/api-contracts/wechat-channels-api.md +0 -809
  256. package/skills/meta-capability/references/api-contracts/wechat-media-platform-web-api.md +0 -677
  257. package/skills/meta-capability/references/api-contracts/weibo-app-api.md +0 -1547
  258. package/skills/meta-capability/references/api-contracts/weibo-web-api.md +0 -798
  259. package/skills/meta-capability/references/api-contracts/weibo-web-v2-api.md +0 -2459
  260. package/skills/meta-capability/references/api-contracts/xiaohongshu-app-api.md +0 -1291
  261. package/skills/meta-capability/references/api-contracts/xiaohongshu-app-v2-api.md +0 -1683
  262. package/skills/meta-capability/references/api-contracts/xiaohongshu-web-api.md +0 -1324
  263. package/skills/meta-capability/references/api-contracts/xiaohongshu-web-v2-api.md +0 -1209
  264. package/skills/meta-capability/references/api-contracts/xigua-app-v2-api.md +0 -489
  265. package/skills/meta-capability/references/api-contracts/youtube-web-api.md +0 -2636
  266. package/skills/meta-capability/references/api-contracts/youtube-web-v2-api.md +0 -2660
  267. package/skills/meta-capability/references/api-contracts/zhihu-web-api.md +0 -2315
  268. package/skills/meta-capability/references/api-tags/asr-api.md +0 -100
  269. package/skills/meta-capability/references/api-tags/bilibili-app-api.md +0 -482
  270. package/skills/meta-capability/references/api-tags/bilibili-web-api.md +0 -1267
  271. package/skills/meta-capability/references/api-tags/demo-api.md +0 -365
  272. package/skills/meta-capability/references/api-tags/douyin-app-v3-api.md +0 -2012
  273. package/skills/meta-capability/references/api-tags/douyin-billboard-api.md +0 -1428
  274. package/skills/meta-capability/references/api-tags/douyin-creator-api.md +0 -694
  275. package/skills/meta-capability/references/api-tags/douyin-creator-v2-api.md +0 -694
  276. package/skills/meta-capability/references/api-tags/douyin-search-api.md +0 -1059
  277. package/skills/meta-capability/references/api-tags/douyin-web-api.md +0 -3314
  278. package/skills/meta-capability/references/api-tags/douyin-xingtu-api.md +0 -935
  279. package/skills/meta-capability/references/api-tags/douyin-xingtu-v2-api.md +0 -925
  280. package/skills/meta-capability/references/api-tags/health-check.md +0 -40
  281. package/skills/meta-capability/references/api-tags/hybrid-parsing.md +0 -57
  282. package/skills/meta-capability/references/api-tags/instagram-v1-api.md +0 -1224
  283. package/skills/meta-capability/references/api-tags/instagram-v2-api.md +0 -1147
  284. package/skills/meta-capability/references/api-tags/instagram-v3-api.md +0 -1123
  285. package/skills/meta-capability/references/api-tags/ios-shortcut.md +0 -45
  286. package/skills/meta-capability/references/api-tags/kuaishou-app-api.md +0 -846
  287. package/skills/meta-capability/references/api-tags/kuaishou-web-api.md +0 -551
  288. package/skills/meta-capability/references/api-tags/lemon8-app-api.md +0 -687
  289. package/skills/meta-capability/references/api-tags/linkedin-web-api.md +0 -1105
  290. package/skills/meta-capability/references/api-tags/media-ingest-api.md +0 -112
  291. package/skills/meta-capability/references/api-tags/pipixia-app-api.md +0 -721
  292. package/skills/meta-capability/references/api-tags/reddit-app-api.md +0 -1057
  293. package/skills/meta-capability/references/api-tags/sora2-api.md +0 -737
  294. package/skills/meta-capability/references/api-tags/temp-mail-api.md +0 -136
  295. package/skills/meta-capability/references/api-tags/threads-web-api.md +0 -472
  296. package/skills/meta-capability/references/api-tags/tikhub-downloader-api.md +0 -65
  297. package/skills/meta-capability/references/api-tags/tikhub-user-api.md +0 -253
  298. package/skills/meta-capability/references/api-tags/tiktok-ads-api.md +0 -1393
  299. package/skills/meta-capability/references/api-tags/tiktok-analytics-api.md +0 -179
  300. package/skills/meta-capability/references/api-tags/tiktok-app-v3-api.md +0 -3264
  301. package/skills/meta-capability/references/api-tags/tiktok-creator-api.md +0 -709
  302. package/skills/meta-capability/references/api-tags/tiktok-interaction-api.md +0 -366
  303. package/skills/meta-capability/references/api-tags/tiktok-shop-web-api.md +0 -663
  304. package/skills/meta-capability/references/api-tags/tiktok-web-api.md +0 -2516
  305. package/skills/meta-capability/references/api-tags/toutiao-app-api.md +0 -220
  306. package/skills/meta-capability/references/api-tags/toutiao-web-api.md +0 -96
  307. package/skills/meta-capability/references/api-tags/twitter-web-api.md +0 -562
  308. package/skills/meta-capability/references/api-tags/wechat-channels-api.md +0 -405
  309. package/skills/meta-capability/references/api-tags/wechat-media-platform-web-api.md +0 -431
  310. package/skills/meta-capability/references/api-tags/weibo-app-api.md +0 -851
  311. package/skills/meta-capability/references/api-tags/weibo-web-api.md +0 -470
  312. package/skills/meta-capability/references/api-tags/weibo-web-v2-api.md +0 -1405
  313. package/skills/meta-capability/references/api-tags/xiaohongshu-app-api.md +0 -534
  314. package/skills/meta-capability/references/api-tags/xiaohongshu-app-v2-api.md +0 -934
  315. package/skills/meta-capability/references/api-tags/xiaohongshu-web-api.md +0 -757
  316. package/skills/meta-capability/references/api-tags/xiaohongshu-web-v2-api.md +0 -762
  317. package/skills/meta-capability/references/api-tags/xigua-app-v2-api.md +0 -308
  318. package/skills/meta-capability/references/api-tags/youtube-web-api.md +0 -934
  319. package/skills/meta-capability/references/api-tags/youtube-web-v2-api.md +0 -717
  320. package/skills/meta-capability/references/api-tags/zhihu-web-api.md +0 -1384
  321. package/skills/meta-capability/references/config-templates/defaults.yaml +0 -18
  322. package/skills/meta-capability/references/dispatch.md +0 -27
  323. package/skills/meta-capability/references/execution-guidelines.md +0 -25
  324. package/skills/meta-capability/references/implemented-route-map.md +0 -177
  325. package/skills/meta-capability/references/service-guides/asr-u2-u3-fallback.md +0 -75
  326. package/skills/meta-capability/scripts/__init__.py +0 -1
  327. package/skills/meta-capability/scripts/call_route.py +0 -141
  328. package/skills/meta-capability/scripts/core/__init__.py +0 -1
  329. package/skills/meta-capability/scripts/core/bootstrap_env.py +0 -32
  330. package/skills/meta-capability/scripts/core/config_loader.py +0 -204
  331. package/skills/meta-capability/scripts/core/tikomni_common.py +0 -443
  332. package/skills/meta-capability/scripts/test_auth.py +0 -98
  333. package/skills/single-work-analysis/SKILL.md +0 -62
  334. package/skills/single-work-analysis/agents/openai.yaml +0 -4
  335. package/skills/single-work-analysis/env.example +0 -36
  336. package/skills/single-work-analysis/references/api-capability-index.md +0 -92
  337. package/skills/single-work-analysis/references/api-contracts/asr-api.md +0 -130
  338. package/skills/single-work-analysis/references/api-contracts/bilibili-app-api.md +0 -776
  339. package/skills/single-work-analysis/references/api-contracts/bilibili-web-api.md +0 -2017
  340. package/skills/single-work-analysis/references/api-contracts/demo-api.md +0 -717
  341. package/skills/single-work-analysis/references/api-contracts/douyin-app-v3-api.md +0 -3594
  342. package/skills/single-work-analysis/references/api-contracts/douyin-billboard-api.md +0 -2274
  343. package/skills/single-work-analysis/references/api-contracts/douyin-creator-api.md +0 -1575
  344. package/skills/single-work-analysis/references/api-contracts/douyin-creator-v2-api.md +0 -3254
  345. package/skills/single-work-analysis/references/api-contracts/douyin-search-api.md +0 -4118
  346. package/skills/single-work-analysis/references/api-contracts/douyin-web-api.md +0 -5544
  347. package/skills/single-work-analysis/references/api-contracts/douyin-xingtu-api.md +0 -1916
  348. package/skills/single-work-analysis/references/api-contracts/douyin-xingtu-v2-api.md +0 -1540
  349. package/skills/single-work-analysis/references/api-contracts/health-check.md +0 -69
  350. package/skills/single-work-analysis/references/api-contracts/hybrid-parsing.md +0 -78
  351. package/skills/single-work-analysis/references/api-contracts/instagram-v1-api.md +0 -2256
  352. package/skills/single-work-analysis/references/api-contracts/instagram-v2-api.md +0 -2011
  353. package/skills/single-work-analysis/references/api-contracts/instagram-v3-api.md +0 -2630
  354. package/skills/single-work-analysis/references/api-contracts/ios-shortcut.md +0 -44
  355. package/skills/single-work-analysis/references/api-contracts/kuaishou-app-api.md +0 -1518
  356. package/skills/single-work-analysis/references/api-contracts/kuaishou-web-api.md +0 -1242
  357. package/skills/single-work-analysis/references/api-contracts/lemon8-app-api.md +0 -1088
  358. package/skills/single-work-analysis/references/api-contracts/linkedin-web-api.md +0 -1949
  359. package/skills/single-work-analysis/references/api-contracts/media-ingest-api.md +0 -126
  360. package/skills/single-work-analysis/references/api-contracts/pipixia-app-api.md +0 -1142
  361. package/skills/single-work-analysis/references/api-contracts/reddit-app-api.md +0 -2025
  362. package/skills/single-work-analysis/references/api-contracts/sora2-api.md +0 -2266
  363. package/skills/single-work-analysis/references/api-contracts/temp-mail-api.md +0 -208
  364. package/skills/single-work-analysis/references/api-contracts/threads-web-api.md +0 -897
  365. package/skills/single-work-analysis/references/api-contracts/tikhub-downloader-api.md +0 -134
  366. package/skills/single-work-analysis/references/api-contracts/tikhub-user-api.md +0 -494
  367. package/skills/single-work-analysis/references/api-contracts/tiktok-ads-api.md +0 -5947
  368. package/skills/single-work-analysis/references/api-contracts/tiktok-analytics-api.md +0 -968
  369. package/skills/single-work-analysis/references/api-contracts/tiktok-app-v3-api.md +0 -5735
  370. package/skills/single-work-analysis/references/api-contracts/tiktok-creator-api.md +0 -1951
  371. package/skills/single-work-analysis/references/api-contracts/tiktok-interaction-api.md +0 -742
  372. package/skills/single-work-analysis/references/api-contracts/tiktok-shop-web-api.md +0 -1890
  373. package/skills/single-work-analysis/references/api-contracts/tiktok-web-api.md +0 -4448
  374. package/skills/single-work-analysis/references/api-contracts/toutiao-app-api.md +0 -342
  375. package/skills/single-work-analysis/references/api-contracts/toutiao-web-api.md +0 -143
  376. package/skills/single-work-analysis/references/api-contracts/twitter-web-api.md +0 -989
  377. package/skills/single-work-analysis/references/api-contracts/wechat-channels-api.md +0 -809
  378. package/skills/single-work-analysis/references/api-contracts/wechat-media-platform-web-api.md +0 -677
  379. package/skills/single-work-analysis/references/api-contracts/weibo-app-api.md +0 -1547
  380. package/skills/single-work-analysis/references/api-contracts/weibo-web-api.md +0 -798
  381. package/skills/single-work-analysis/references/api-contracts/weibo-web-v2-api.md +0 -2459
  382. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-app-api.md +0 -1291
  383. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-app-v2-api.md +0 -1683
  384. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-web-api.md +0 -1324
  385. package/skills/single-work-analysis/references/api-contracts/xiaohongshu-web-v2-api.md +0 -1209
  386. package/skills/single-work-analysis/references/api-contracts/xigua-app-v2-api.md +0 -489
  387. package/skills/single-work-analysis/references/api-contracts/youtube-web-api.md +0 -2636
  388. package/skills/single-work-analysis/references/api-contracts/youtube-web-v2-api.md +0 -2660
  389. package/skills/single-work-analysis/references/api-contracts/zhihu-web-api.md +0 -2315
  390. package/skills/single-work-analysis/references/api-tags/asr-api.md +0 -100
  391. package/skills/single-work-analysis/references/api-tags/bilibili-app-api.md +0 -482
  392. package/skills/single-work-analysis/references/api-tags/bilibili-web-api.md +0 -1267
  393. package/skills/single-work-analysis/references/api-tags/demo-api.md +0 -365
  394. package/skills/single-work-analysis/references/api-tags/douyin-app-v3-api.md +0 -2012
  395. package/skills/single-work-analysis/references/api-tags/douyin-billboard-api.md +0 -1428
  396. package/skills/single-work-analysis/references/api-tags/douyin-creator-api.md +0 -694
  397. package/skills/single-work-analysis/references/api-tags/douyin-creator-v2-api.md +0 -694
  398. package/skills/single-work-analysis/references/api-tags/douyin-search-api.md +0 -1059
  399. package/skills/single-work-analysis/references/api-tags/douyin-web-api.md +0 -3314
  400. package/skills/single-work-analysis/references/api-tags/douyin-xingtu-api.md +0 -935
  401. package/skills/single-work-analysis/references/api-tags/douyin-xingtu-v2-api.md +0 -925
  402. package/skills/single-work-analysis/references/api-tags/health-check.md +0 -40
  403. package/skills/single-work-analysis/references/api-tags/hybrid-parsing.md +0 -57
  404. package/skills/single-work-analysis/references/api-tags/instagram-v1-api.md +0 -1224
  405. package/skills/single-work-analysis/references/api-tags/instagram-v2-api.md +0 -1147
  406. package/skills/single-work-analysis/references/api-tags/instagram-v3-api.md +0 -1123
  407. package/skills/single-work-analysis/references/api-tags/ios-shortcut.md +0 -45
  408. package/skills/single-work-analysis/references/api-tags/kuaishou-app-api.md +0 -846
  409. package/skills/single-work-analysis/references/api-tags/kuaishou-web-api.md +0 -551
  410. package/skills/single-work-analysis/references/api-tags/lemon8-app-api.md +0 -687
  411. package/skills/single-work-analysis/references/api-tags/linkedin-web-api.md +0 -1105
  412. package/skills/single-work-analysis/references/api-tags/media-ingest-api.md +0 -112
  413. package/skills/single-work-analysis/references/api-tags/pipixia-app-api.md +0 -721
  414. package/skills/single-work-analysis/references/api-tags/reddit-app-api.md +0 -1057
  415. package/skills/single-work-analysis/references/api-tags/sora2-api.md +0 -737
  416. package/skills/single-work-analysis/references/api-tags/temp-mail-api.md +0 -136
  417. package/skills/single-work-analysis/references/api-tags/threads-web-api.md +0 -472
  418. package/skills/single-work-analysis/references/api-tags/tikhub-downloader-api.md +0 -65
  419. package/skills/single-work-analysis/references/api-tags/tikhub-user-api.md +0 -253
  420. package/skills/single-work-analysis/references/api-tags/tiktok-ads-api.md +0 -1393
  421. package/skills/single-work-analysis/references/api-tags/tiktok-analytics-api.md +0 -179
  422. package/skills/single-work-analysis/references/api-tags/tiktok-app-v3-api.md +0 -3264
  423. package/skills/single-work-analysis/references/api-tags/tiktok-creator-api.md +0 -709
  424. package/skills/single-work-analysis/references/api-tags/tiktok-interaction-api.md +0 -366
  425. package/skills/single-work-analysis/references/api-tags/tiktok-shop-web-api.md +0 -663
  426. package/skills/single-work-analysis/references/api-tags/tiktok-web-api.md +0 -2516
  427. package/skills/single-work-analysis/references/api-tags/toutiao-app-api.md +0 -220
  428. package/skills/single-work-analysis/references/api-tags/toutiao-web-api.md +0 -96
  429. package/skills/single-work-analysis/references/api-tags/twitter-web-api.md +0 -562
  430. package/skills/single-work-analysis/references/api-tags/wechat-channels-api.md +0 -405
  431. package/skills/single-work-analysis/references/api-tags/wechat-media-platform-web-api.md +0 -431
  432. package/skills/single-work-analysis/references/api-tags/weibo-app-api.md +0 -851
  433. package/skills/single-work-analysis/references/api-tags/weibo-web-api.md +0 -470
  434. package/skills/single-work-analysis/references/api-tags/weibo-web-v2-api.md +0 -1405
  435. package/skills/single-work-analysis/references/api-tags/xiaohongshu-app-api.md +0 -534
  436. package/skills/single-work-analysis/references/api-tags/xiaohongshu-app-v2-api.md +0 -934
  437. package/skills/single-work-analysis/references/api-tags/xiaohongshu-web-api.md +0 -757
  438. package/skills/single-work-analysis/references/api-tags/xiaohongshu-web-v2-api.md +0 -762
  439. package/skills/single-work-analysis/references/api-tags/xigua-app-v2-api.md +0 -308
  440. package/skills/single-work-analysis/references/api-tags/youtube-web-api.md +0 -934
  441. package/skills/single-work-analysis/references/api-tags/youtube-web-v2-api.md +0 -717
  442. package/skills/single-work-analysis/references/api-tags/zhihu-web-api.md +0 -1384
  443. package/skills/single-work-analysis/references/asr-and-fallback.md +0 -20
  444. package/skills/single-work-analysis/references/config-templates/defaults.yaml +0 -47
  445. package/skills/single-work-analysis/references/contracts/work-card-fields.md +0 -41
  446. package/skills/single-work-analysis/references/platform-guides/douyin.md +0 -47
  447. package/skills/single-work-analysis/references/platform-guides/generic.md +0 -43
  448. package/skills/single-work-analysis/references/platform-guides/xiaohongshu.md +0 -54
  449. package/skills/single-work-analysis/references/prompt-contracts/analysis-bundle.md +0 -82
  450. package/skills/single-work-analysis/references/schemas/work-card.schema.json +0 -39
  451. package/skills/single-work-analysis/references/service-guides/asr-u2-u3-fallback.md +0 -75
  452. package/skills/single-work-analysis/scripts/__init__.py +0 -0
  453. package/skills/single-work-analysis/scripts/core/__init__.py +0 -0
  454. package/skills/single-work-analysis/scripts/core/analysis_adapter.py +0 -384
  455. package/skills/single-work-analysis/scripts/core/analysis_pipeline.py +0 -456
  456. package/skills/single-work-analysis/scripts/core/bootstrap_env.py +0 -35
  457. package/skills/single-work-analysis/scripts/core/extract_pipeline.py +0 -173
  458. package/skills/single-work-analysis/scripts/core/progress_report.py +0 -258
  459. package/skills/single-work-analysis/scripts/core/storage_router.py +0 -220
  460. package/skills/single-work-analysis/scripts/pipeline/__init__.py +0 -0
  461. package/skills/single-work-analysis/scripts/pipeline/asr/__init__.py +0 -0
  462. package/skills/single-work-analysis/scripts/platform/__init__.py +0 -0
  463. package/skills/single-work-analysis/scripts/platform/douyin/__init__.py +0 -0
  464. package/skills/single-work-analysis/scripts/platform/douyin/douyin_video_type_matrix.py +0 -224
  465. package/skills/single-work-analysis/scripts/platform/douyin/select_low_quality_video_url.py +0 -200
  466. package/skills/single-work-analysis/scripts/platform/xiaohongshu/__init__.py +0 -0
  467. package/skills/single-work-analysis/scripts/writers/__init__.py +0 -0
  468. package/skills/single-work-analysis/scripts/writers/write_benchmark_card.py +0 -752
  469. /package/skills/{creator-analysis → social-media-crawl}/scripts/core/bootstrap_env.py +0 -0
  470. /package/skills/{creator-analysis → social-media-crawl}/scripts/core/extract_pipeline.py +0 -0
  471. /package/skills/{single-work-analysis → social-media-crawl}/scripts/core/tikomni_common.py +0 -0
  472. /package/skills/{creator-analysis/scripts/platform/douyin → social-media-crawl/scripts/pipelines}/douyin_video_type_matrix.py +0 -0
  473. /package/skills/{creator-analysis/scripts/author_home/collectors → social-media-crawl/scripts/pipelines}/homepage_collectors.py +0 -0
  474. /package/skills/{creator-analysis/scripts/platform/douyin → social-media-crawl/scripts/pipelines}/select_low_quality_video_url.py +0 -0
@@ -1,33 +0,0 @@
1
- # Creator ASR Orchestration
2
-
3
- ## Primary Path
4
-
5
- - Read `references/service-guides/asr-u2-u3-fallback.md` first and follow the shared flow: U2 primary path -> 90-second soft observation -> 120-second hard fallback -> U3 -> back to U2.
6
- - Video items in creator or profile tasks must prefer batch ASR.
7
- - The per-batch request limit is 100 `video_download_url` values.
8
- - Do not treat one-by-one serial or one-by-one parallel ASR calls as the primary path for creator tasks.
9
-
10
- ## Two-Level Source Order
11
-
12
- 1. If the route directly returns `subtitle_raw`:
13
- - map it to `asr_raw` first
14
- 2. If `subtitle_raw` is unavailable:
15
- - call ASR with `video_download_url`
16
-
17
- ## Timeout and Fallback
18
-
19
- - 90 seconds: soft observation threshold.
20
- - 120 seconds: hard fallback threshold.
21
- - If the batch is still incomplete after 120 seconds, run upload-media fallback only for the unsuccessful subset.
22
-
23
- ## Upload-Media Fallback
24
-
25
- 1. Call the upstream request route and obtain a temporary upload URL.
26
- 2. Download or stream-relay the no-watermark video resource.
27
- 3. Call the completion route and obtain a publicly readable URL.
28
- 4. Call ASR again with the public URL.
29
-
30
- ## Failure End State
31
-
32
- - If the upstream media-upload route is unavailable, mark the unsuccessful subset as `analysis_eligibility=incomplete`.
33
- - Keep fact cards for items with `analysis_eligibility=incomplete`, but exclude them from sampling, sampled explanations, and `author_analysis_v2`.
@@ -1,60 +0,0 @@
1
- schema_version: v1
2
- profile: default
3
-
4
- runtime:
5
- base_url: "https://api.tikomni.com"
6
- auth_env_key: "TIKOMNI_API_KEY"
7
- timeout_ms: 60000
8
-
9
- storage_routes:
10
- default:
11
- root_dir: ""
12
- runs_dir: "_runs"
13
- results_dir: "results"
14
- errors_dir: "_errors"
15
- content_kind_card_type:
16
- single_video: work
17
- work: work
18
- author_home: author_sample_work
19
- author_sample_work: author_sample_work
20
- author_analysis: author
21
- card_type_routes:
22
- work:
23
- prefix: "CBV"
24
- parts:
25
- - "内容系统"
26
- - "对标研究"
27
- - "作品卡"
28
- author:
29
- prefix: "CBA"
30
- parts:
31
- - "内容系统"
32
- - "对标研究"
33
- - "作者卡"
34
- author_sample_work:
35
- prefix: "CBV"
36
- parts:
37
- - "内容系统"
38
- - "对标研究"
39
- - "作者样本卡"
40
- - "{platform}-{author_slug}"
41
-
42
- naming_rules:
43
- card_filename_pattern: "{prefix}-{author_slug}-{title_slug}{ext}"
44
- json_filename_pattern: "{timestamp}-{platform}-{identifier}{ext}"
45
-
46
- asr_strategy:
47
- poll_interval_sec: 3.0
48
- max_polls: 30
49
- submit_retry:
50
- douyin_video:
51
- max_retries: 2
52
- backoff_ms: 1500
53
- xiaohongshu_note:
54
- max_retries: 0
55
- backoff_ms: 0
56
- u2_timeout_retry:
57
- enabled: true
58
- max_retries: 3
59
- author_home:
60
- batch_submit_size: 50
@@ -1,25 +0,0 @@
1
- # Creator Card Fields
2
-
3
- ## Fixed Display Fields
4
-
5
- - `platform`
6
- - `platform_author_id`
7
- - `author_handle`
8
- - `nickname`
9
- - `ip_location`
10
- - `signature`
11
- - `avatar_url`
12
- - `fans_count`
13
- - `liked_count`
14
- - `collected_count`
15
- - `works_count`
16
- - `verified`
17
- - `snapshot_at`
18
-
19
- ## Key Rules
20
-
21
- - The creator card is the fact container for creator-level data.
22
- - The creator-level analysis body comes from `author_analysis_v2`, not from platform process fields.
23
- - The creator-card body should present the `author_analysis_v2` modules and representative works, not a raw JSON dump.
24
- - Debug JSON, validation, and trace data belong in appendix/details blocks rather than the main body.
25
- - Platform-native IDs stay in the internal reference layer and should not appear in the final creator-card body.
@@ -1,68 +0,0 @@
1
- # Creator Analysis Work Card Fields
2
-
3
- ## Card Roles
4
-
5
- - `author_sample_card`
6
- - Fact-and-structure card for every retrieved work in creator analysis.
7
- - `sample_work_card`
8
- - Sampled-only enhanced card that reuses the same fact-and-structure fields and adds the explanation block.
9
-
10
- ## Fixed Display Fields
11
-
12
- - `platform`
13
- - `platform_work_id`
14
- - `platform_author_id`
15
- - `author_handle`
16
- - `title`
17
- - `caption_raw`
18
- - `work_modality`
19
- - `published_date`
20
- - `digg_count`
21
- - `comment_count`
22
- - `collect_count`
23
- - `share_count`
24
- - `play_count`
25
- - `cover_image`
26
- - `source_url`
27
- - `share_url`
28
- - `primary_text`
29
-
30
- ## Structural Display Fields
31
-
32
- - `performance_score`
33
- - `performance_score_norm`
34
- - `bucket`
35
- - `hook_type`
36
- - `structure_type`
37
- - `cta_type`
38
- - `content_form`
39
- - `style_markers`
40
- - `tags`
41
-
42
- ## Shared Appendix Fields
43
-
44
- - `analysis_eligibility`
45
- - `analysis_exclusion_reason`
46
-
47
- ## Video-Only Appendix Fields
48
-
49
- - `asr_raw`
50
- - `video_download_url`
51
-
52
- ## Sampled-Only Explanation Block
53
-
54
- - `sampled_explanation.why_it_worked_or_failed`
55
- - `sampled_explanation.copyable_elements`
56
- - `sampled_explanation.non_copyable_elements`
57
- - `sampled_explanation.emotional_triggers`
58
- - `sampled_explanation.cognitive_gap`
59
- - `sampled_explanation.commercial_signal`
60
-
61
- ## Key Rules
62
-
63
- - Keep author sample cards for all retrieved works.
64
- - Only sampled works receive the sampled explanation block.
65
- - The final card should not expose `content_type`, `publish_time`, `create_time_sec`, `subtitle_raw`, `asr_source`, `asr_status`, or `asr_error_reason`.
66
- - Use `primary_text` as the main reading body and keep `asr_raw` in appendix/details only.
67
- - If a video item cannot obtain `asr_raw`, keep the fact card but mark `analysis_eligibility=incomplete` and exclude that item from creator analysis.
68
- - Do not introduce per-work standalone LLM analysis in creator analysis.
@@ -1,54 +0,0 @@
1
- # Douyin Creator Guide
2
-
3
- ## Use This Guide For
4
-
5
- - Use this guide first for Douyin creator, profile, and account tasks.
6
- - The validated creator chain in this repository is profile input -> `sec_user_id` resolution -> creator profile -> paginated post list.
7
-
8
- ## Validated Route Chain
9
-
10
- 1. Resolve `sec_user_id`: `GET /api/u1/v1/douyin/web/get_sec_user_id`
11
- 2. Fetch creator profile: `GET /api/u1/v1/douyin/app/v3/handler_user_profile`
12
- 3. Fetch paginated post list: `GET /api/u1/v1/douyin/app/v3/fetch_user_post_videos`
13
-
14
- ## Required Unified Fields
15
-
16
- - creator side:
17
- - `platform_author_id`
18
- - `author_handle`
19
- - `nickname`
20
- - `ip_location`
21
- - `signature`
22
- - `avatar_url`
23
- - `fans_count`
24
- - `liked_count`
25
- - `works_count`
26
- - `verified`
27
- - work side:
28
- - `platform_work_id`
29
- - `title`
30
- - `caption_raw`
31
- - `published_date`
32
- - `digg_count`
33
- - `comment_count`
34
- - `collect_count`
35
- - `share_count`
36
- - `play_count`
37
- - `cover_image`
38
- - `share_url`
39
- - `source_url`
40
- - `video_download_url`
41
-
42
- ## Route Rules
43
-
44
- - If `sec_user_id` is already available, skip the resolution route.
45
- - Default to the latest-post pagination path. Do not search random feed routes first.
46
- - The post-list route must supply stable `aweme_id`, publish time, and engagement fields before creator analysis can continue.
47
- - If batch U2 ASR is still incomplete after 120 seconds, follow `references/service-guides/asr-u2-u3-fallback.md` and use U3 fallback only for the unsuccessful subset.
48
- - If the profile chain still cannot supply key creator fields, go back to `references/api-capability-index.md` and the matching `references/api-tags/*.md` to find supplemental routes instead of giving up on the creator card.
49
-
50
- ## First Stops In Code
51
-
52
- - Route and pagination behavior: `skills/creator-analysis/scripts/author_home/collectors/homepage_collectors.py`
53
- - Platform-field normalization: `skills/creator-analysis/scripts/author_home/adapters/platform_adapters.py`
54
- - Shared creator pipeline: `skills/creator-analysis/scripts/author_home/orchestrator/run_author_analysis.py`
@@ -1,50 +0,0 @@
1
- # Generic Creator Adaptation Guide
2
-
3
- ## Goal
4
-
5
- Map an unfamiliar platform into the creator-analysis contracts and only then feed it into the shared creator pipeline.
6
-
7
- ## Read Order
8
-
9
- - Start with `references/api-capability-index.md` to lock onto the relevant platform tag.
10
- - Read the matching `references/api-tags/<tag>.md` for route summaries, inputs, request bodies, and success-response summaries.
11
- - Prioritize routes related to `user / author / creator / profile / home / channel / posts / notes / videos`.
12
- - Then read `references/contracts/creator-card-fields.md`, `references/contracts/work-card-fields.md`, and `references/workflow.md`.
13
- - Add comment, media-download, subtitle, and extra-metric routes only when needed.
14
-
15
- ## Minimum Mapping Checklist
16
-
17
- - creator side:
18
-
19
- - `platform_author_id`
20
- - `author_handle`
21
- - `nickname`
22
- - `ip_location`
23
- - `signature`
24
- - `avatar_url`
25
- - `fans_count`
26
- - `liked_count`
27
- - `collected_count`
28
- - `works_count`
29
- - `verified`
30
-
31
- - work side:
32
-
33
- - the required fields from the unified work-card field dictionary
34
- - for video items: `video_download_url`
35
-
36
- ## Route Rules
37
-
38
- - The creator-profile chain must cover both creator information and paginated work-list retrieval. Do not stop at a profile-only route.
39
- - If the platform provides multiple profile routes or posts routes, prefer the variant with fuller fields and more stable pagination.
40
- - The work-list route must reliably provide `platform_work_id` and the main published-time and engagement fields before sampling or aggregation can begin.
41
- - If video items have no subtitles and no download path, mark ASR as infeasible at the route-selection stage.
42
- - Do not invent platform cleaning rules inside the shared layer. Normalize in the platform adapter first.
43
- - If the platform still cannot satisfy the unified creator/work contracts, stop and report the mapping gap instead of pushing half-complete data into creator analysis.
44
- - If batch U2 ASR is still incomplete after 120 seconds, follow `references/service-guides/asr-u2-u3-fallback.md` and use U3 fallback only for the unsuccessful subset.
45
-
46
- ## First Stops For Adaptation
47
-
48
- - Collector and route selection: `skills/creator-analysis/scripts/author_home/collectors/homepage_collectors.py`
49
- - Platform normalization: `skills/creator-analysis/scripts/author_home/adapters/platform_adapters.py`
50
- - Shared creator orchestration: `skills/creator-analysis/scripts/author_home/orchestrator/run_author_analysis.py`
@@ -1,69 +0,0 @@
1
- # Xiaohongshu Creator Guide
2
-
3
- ## Use This Guide For
4
-
5
- - Use this guide first for Xiaohongshu creator, profile, and account tasks.
6
- - The validated creator chain in this repository is profile input -> `user_id` / `xsec_token` resolution -> profile cascade -> post-list cascade.
7
-
8
- ## Preferred Route Comparator
9
-
10
- - source priority: `app > web`
11
- - version priority within the same source: `v2 > v1`
12
- - desired order for the current creator-home pipeline: `app v2 -> app -> web v2`
13
-
14
- ## Validated Route Chain
15
-
16
- 1. Resolve `user_id` / `xsec_token`: `GET /api/u1/v1/xiaohongshu/app/get_user_id_and_xsec_token`
17
- 2. Profile cascade:
18
- - `GET /api/u1/v1/xiaohongshu/app_v2/get_user_info`
19
- - `GET /api/u1/v1/xiaohongshu/app/get_user_info`
20
- - `GET /api/u1/v1/xiaohongshu/web_v2/fetch_user_info_app`
21
- 3. Post-list cascade:
22
- - `GET /api/u1/v1/xiaohongshu/app_v2/get_user_posted_notes`
23
- - `GET /api/u1/v1/xiaohongshu/app/get_user_notes`
24
- - `GET /api/u1/v1/xiaohongshu/web_v2/fetch_home_notes_app`
25
-
26
- ## Required Unified Fields
27
-
28
- - creator side:
29
- - `platform_author_id`
30
- - `author_handle`
31
- - `nickname`
32
- - `ip_location`
33
- - `signature`
34
- - `avatar_url`
35
- - `fans_count`
36
- - `liked_count`
37
- - `collected_count`
38
- - `works_count`
39
- - `verified`
40
- - work side:
41
- - `platform_work_id`
42
- - `title`
43
- - `caption_raw`
44
- - `published_date`
45
- - `digg_count`
46
- - `comment_count`
47
- - `collect_count`
48
- - `share_count`
49
- - `play_count`
50
- - `cover_image`
51
- - `share_url`
52
- - `source_url`
53
- - `video_download_url`
54
-
55
- ## Route Rules
56
-
57
- - If `user_id` is already available, skip the resolution route. Treat `xsec_token` as supplemental rather than universally required.
58
- - Apply the comparator above consistently to both profile and post-list cascades.
59
- - Switch to fallback based on field completeness, not only on HTTP success.
60
- - For the current fixed pipeline, do not add a web-v1 fallback unless a later plan explicitly freezes its endpoint, parameters, and accept rules.
61
- - For video items, prefer native subtitles first; only move into batch ASR when native text is insufficient.
62
- - If batch U2 ASR is still incomplete after 120 seconds, follow `references/service-guides/asr-u2-u3-fallback.md` and use U3 fallback only for the unsuccessful subset.
63
- - If the profile-post chain still cannot provide stable fields, go back to `references/api-capability-index.md` and the matching `references/api-tags/*.md` for supplemental routes instead of sending half-complete data into creator analysis.
64
-
65
- ## First Stops In Code
66
-
67
- - Route and pagination behavior: `skills/creator-analysis/scripts/author_home/collectors/homepage_collectors.py`
68
- - Platform-field normalization: `skills/creator-analysis/scripts/author_home/adapters/platform_adapters.py`
69
- - Shared creator pipeline: `skills/creator-analysis/scripts/author_home/orchestrator/run_author_analysis.py`
@@ -1,28 +0,0 @@
1
- # Prompt Contract · ASR_CLEAN
2
-
3
- ## Inputs
4
- - `raw_content`
5
- - `asr_raw`(统一字幕/转写文本主字段)
6
- - `asr_clean`(遗留兼容字段,仅可作为附加输入)
7
-
8
- ## Method (stable)
9
- 1. 选择输入基底:优先 `asr_raw`,否则 `raw_content`,最后才允许兼容读取 `asr_clean`。
10
- 2. 去噪清洗:移除明显口头禅、重复叠词、异常空白。
11
- 3. 语义断句:按 `。!?;\n` 断句,并补齐句末中文标点。
12
- 4. 分段规则:每句单独一行,每段 2~4 句,段间空一行。
13
- 5. 保真约束:不新增事实、不改写核心结论、不输出提示词文本。
14
-
15
- ## Output Format
16
- - 纯文本多段落:
17
- - 每句一行
18
- - 段间空行
19
-
20
- ## Constraints
21
- - 不把清洗提示词写入正文。
22
- - 不生成“总结式改写”,仅做可读性清洗。
23
- - 不得凭空补充数据、观点和案例。
24
-
25
- ## Fallback / Data-insufficient
26
- - 两个输入均为空:输出空字符串。
27
- - 断句失败:保留原文并补单句句号。
28
- - 超长段落:强制按 3 句一段切分。
@@ -1,46 +0,0 @@
1
- # Author Analysis V2 Prompt Contract
2
-
3
- ## Goal
4
-
5
- 生成结构化的 `author_analysis_v2`,回答作者是谁、为什么可信、内容机制如何运作、能学什么、什么不能学。不要输出松散夸赞文案。
6
-
7
- ## Allowed Inputs
8
-
9
- - 作者卡事实字段
10
- - 全量聚合结果
11
- - Sampled works 的统一事实字段:
12
- - `platform_work_id`
13
- - `title`
14
- - `caption_raw`
15
- - `work_modality`
16
- - `primary_text`
17
- - 互动指标
18
- - 结构标签
19
- - 可选的 `sampled_work_explanations`
20
-
21
- ## Hard Rules
22
-
23
- - 主分析文本始终使用 `primary_text`。
24
- - `title`、`caption_raw`、`asr_raw` 各自语义不同,不得混用。
25
- - 不把 `caption_raw` 当作字幕或 ASR fallback。
26
- - 不进行逐条作品 LLM topic classification。
27
- - 结论优先落在机制层,不写表面夸赞。
28
- - 证据不足时先降置信度,再收窄结论。
29
-
30
- ## Required Output Modules
31
-
32
- - `author_positioning`
33
- - `trust_model`
34
- - `cognitive_engine`
35
- - `expression_hooks`
36
- - `content_mechanism`
37
- - `commercial_bridge`
38
- - `core_tensions`
39
- - `evidence_pack`
40
- - `clone_guidance`
41
-
42
- ## Failure Guards
43
-
44
- - `sample_size < 5` 时不得标高置信度。
45
- - `sampled_work_explanations` 缺失时也必须返回完整的 `author_analysis_v2`,但要在 `evidence_pack` 中降低置信度或说明边界。
46
- - `analysis_eligibility=incomplete` 的作品不得进入证据样本。
@@ -1,49 +0,0 @@
1
- # Prompt Contract · 作者对标分析(author-analysis)
2
-
3
- ## User Prompt (Verbatim)
4
-
5
- ```text
6
- 你是“内容商业增长顾问 + 对标拆解师”。
7
- 目标:基于作者主页资料与作品样本,输出作者对标分析 JSON。
8
-
9
- 硬约束:
10
- 1) 只输出 JSON 对象,不要 markdown,不要解释。
11
- 2) 字段必须完整、类型必须正确。
12
- 3) 不得捏造事实;缺数据时用“数据不足”或保守分值。
13
- 4) 评分范围 0-100。
14
-
15
- 输出 Schema:
16
- {
17
- "author_portrait": "string",
18
- "business_analysis": "string",
19
- "benchmark_analysis": "string",
20
- "business_score": 0,
21
- "benchmark_gap_score": 0,
22
- "style_radar": {
23
- "选题": 0,
24
- "表达": 0,
25
- "结构": 0,
26
- "节奏": 0,
27
- "人设": 0,
28
- "转化": 0,
29
- "差异化": 0,
30
- "稳定性": 0
31
- },
32
- "core_contradictions": ["string"],
33
- "recommendations": ["string"]
34
- }
35
-
36
- 口径:
37
- - 先给结论,再给理由。
38
- - recommendations 必须可执行,最多 5 条。
39
- - core_contradictions 必须是“现状冲突”而非空泛观点。
40
- ```
41
-
42
- ## Inputs
43
- - `author_profile`
44
- - `works`(含 `title/desc/asr_raw/subtitle_raw/asr_source/metrics/tags/content_type`)
45
-
46
- ## Constraints
47
- - 仅基于输入推断,不得臆造。
48
- - 输出中文,简洁直接。
49
- - 缺数据时明确标注“数据不足”。
@@ -1,24 +0,0 @@
1
- # Prompt Contract · CTA
2
-
3
- ## Inputs
4
- - `asr_raw`(主字段)
5
- - `asr_clean`(遗留兼容字段)
6
-
7
- ## Method (stable)
8
- 1. 扫描 CTA 关键词句(评论/关注/私信/收藏/转发/领取/报名/咨询/下单)。
9
- 2. 判定 CTA 类型:互动型 / 线索型 / 转化型。
10
- 3. 提取关键动作句(默认取最后一个 CTA 句)。
11
- 4. 计算 CTA 密度(CTA句数/总句数)。
12
-
13
- ## Output Format
14
- - `CTA类型`:`互动型、线索型...`
15
- - `关键动作句`:`原句`
16
- - `CTA密度`:`x/y 句`
17
-
18
- ## Constraints
19
- - 必须给出至少一个动作句或明确说明缺失。
20
- - 不得虚构转化链路。
21
-
22
- ## Fallback / Data-insufficient
23
- - 字幕/转写文本为空:输出“数据不足”。
24
- - 无 CTA 句:输出“未检测到明确行动号召”,并给最小补全建议。
@@ -1,25 +0,0 @@
1
- # Prompt Contract · Hook
2
-
3
- ## Inputs
4
- - `title`
5
- - `asr_raw`(主字段)
6
- - `asr_clean`(遗留兼容字段)
7
-
8
- ## Method (stable)
9
- 1. 提取开头钩子:ASR 首句(无则用标题)。
10
- 2. 提取中段钩子:ASR 中位句。
11
- 3. 提取结尾钩子:最后一句含 CTA/召回词的句子。
12
- 4. 开头钩子类型判定:疑问式 / 反常识式 / 场景代入式 / 陈述式。
13
-
14
- ## Output Format
15
- - `开头钩子(类型)`:`原句`
16
- - `中段钩子`:`原句`
17
- - `结尾钩子`:`原句`
18
-
19
- ## Constraints
20
- - 必须优先输出原话,不做大幅改写。
21
- - 结尾若无动作句要明确标注“未检测到明确结尾钩子”。
22
-
23
- ## Fallback / Data-insufficient
24
- - 标题与 ASR 均缺失:三项输出“数据不足”。
25
- - 中段不足:输出“数据不足(中段文本不足)”。
@@ -1,47 +0,0 @@
1
- # Prompt Contract · 洞察分析(insight)
2
-
3
- ## User Prompt (Verbatim)
4
-
5
- ```text
6
- === 你的身份 ===
7
- 一位见证了无数内容起落的观察者,曾亲手打造过刷屏级作品,也经历过石沉大海的落寞。
8
- 你能透过表象看到人性的涌动,理解为什么有些内容能击中集体潜意识。
9
- === 核心信念 ===
10
- 爆款不是运气的产物,而是人性规律的必然显现。
11
- 真正的洞察者不追逐热点,而是理解热点背后的情感暗流。
12
- === 分析维度 ===
13
- - 情绪共振点:触发了哪根集体心弦
14
- - 认知势能差:创造了怎样的信息落差
15
- - 社交货币值:给了人们什么谈资筹码
16
- - 行动驱动力:激发了哪种传播冲动
17
- === 洞察深度 ===
18
- 像考古学家解读文物,你要揭示:
19
- - 表层吸引力(第一眼为什么会停留)
20
- - 中层粘性(为什么会看完)
21
- - 深层共鸣(为什么会转发)
22
- - 底层动机(满足了什么心理需求)
23
- === 表达方式 ===
24
- 如同品酒师描述佳酿——既有专业的解构,也有诗意的感受。
25
- 用清晰的逻辑拆解成功密码,用生动的类比让洞察可感知。
26
- === 独特价值 ===
27
- 不做事后诸葛亮式的解释,而是提炼可复用的原理。
28
- 让创作者读完后恍然大悟:"原来爆款的秘密藏在这里。"
29
- === 分析美学 ===
30
- 呈现如解剖图般精准,又如水墨画般留有想象空间。
31
- 既见树木(具体技巧),也见森林(传播规律)。
32
- === 终极使命 ===
33
- 帮助创作者建立"爆款直觉"——
34
- 不是教他们追逐每一个热点,而是理解什么样的内容天生具有传播基因。
35
- ```
36
-
37
- ## Inputs
38
- - `title`
39
- - `asr_raw`(优先)
40
- - `raw_content`(`asr_raw` 缺失时回退)
41
- - `asr_clean`(遗留兼容字段)
42
- - 指标:`digg_count/comment_count/collect_count/share_count/play_count`
43
-
44
- ## Constraints
45
- - 仅基于输入字段推断,不得臆造事实。
46
- - 输出为中文,短句、可执行、可追溯。
47
- - 缺数据时明确标注“数据不足”。
@@ -1,30 +0,0 @@
1
- # Sampled Work Batch Explanations Prompt Contract
2
-
3
- ## Goal
4
-
5
- 对 sampled works 进行一次批量解释,补充单作品层没有的解释性字段。只允许一次批量调用,不允许逐条调用。
6
-
7
- ## Allowed Inputs
8
-
9
- - Sampled works 的统一事实字段
10
- - 作品级结构标签
11
- - 聚合差异信息
12
-
13
- ## Required Output
14
-
15
- 顶层输出 `sampled_work_explanations`,以 `platform_work_id` 为 key。
16
-
17
- 每个 sampled work 必须包含:
18
-
19
- - `why_it_worked_or_failed`
20
- - `copyable_elements`
21
- - `non_copyable_elements`
22
- - `emotional_triggers`
23
- - `cognitive_gap`
24
- - `commercial_signal`
25
-
26
- ## Hard Rules
27
-
28
- - 只解释 sampled works,不解释全量作品。
29
- - 不得伪造作品中不存在的商业信号或情绪机制。
30
- - 不得把结果直接写成作者级结论;作者级结论归 `author_analysis_v2`。
@@ -1,25 +0,0 @@
1
- # Prompt Contract · 结构(structure)
2
-
3
- ## Inputs
4
- - `asr_raw`(主字段)
5
- - `asr_clean`(遗留兼容字段,不应被前置依赖)
6
-
7
- ## Method (stable)
8
- 1. 对每句进行结构标签检测:`钩子/冲突/转折/举证/CTA`。
9
- 2. 统计各标签覆盖次数。
10
- 3. 根据覆盖度判定模板:
11
- - 覆盖 >=4:`钩子→冲突→转折→举证→CTA`
12
- - 否则:`钩子→观点→补充说明`
13
- 4. 输出缺失模块,作为改写优先级。
14
-
15
- ## Output Format
16
- - `结构标签覆盖`:`钩子:a, 冲突:b, 转折:c, 举证:d, CTA:e`
17
- - `模板判定`:`...`
18
- - `缺失模块`:`模块1、模块2`(无则“无”)
19
-
20
- ## Constraints
21
- - 所有判断必须来自句级关键词命中。
22
- - 不允许跳过缺失项输出。
23
-
24
- ## Fallback / Data-insufficient
25
- - 无有效分句:输出“数据不足”,并提示“补充字幕/转写文本后再做结构标注”。
@@ -1,27 +0,0 @@
1
- # Prompt Contract · 文风(style)
2
-
3
- ## Inputs
4
- - `title`
5
- - `asr_raw`(主字段)
6
- - `asr_clean`(遗留兼容字段)
7
-
8
- ## Method (stable)
9
- 1. 分句后统计平均句长(短/中/长)。
10
- 2. 统计疑问/感叹/陈述分布。
11
- 3. 统计人设代词(我/你/我们/大家)与修辞触发词(不是/而是/其实/必须)。
12
- 4. 输出“人设+句式+语气”三层结论。
13
-
14
- ## Output Format
15
- - `句式结构`:`<类型>,平均句长约 X 字`
16
- - `语气分布`:`疑问 A / 感叹 B / 陈述 C`
17
- - `人设与修辞`:`人设代词命中 N 次,强调/转折词命中 M 次`
18
-
19
- ## Constraints
20
- - 至少 2 个统计指标;禁止空泛描述。
21
- - 仅基于文本统计,不猜测作者背景。
22
- - 不输出表格。
23
-
24
- ## Fallback / Data-insufficient
25
- - `asr_raw`(主字段)
26
- - `asr_clean`(遗留兼容字段) 为空:三项均输出“数据不足”。
27
- - 分句失败:标注“需人工复核”。