Koinon Skill —— 给你的 AI 加上创作者情报

通过一个开放的 Skill,把 Koinon 的跨平台创作者数据库接给你的 AI。

Skill 替你做什么

这个 Skill 教会你的 AI 助手三件事:什么时候一个问题其实是在问创作者;怎么检索并读取 Koinon 的 86K+ 个创作者实体;以及拿到结果之后该怎么对待它。

• 什么时候该用 Koinon —— 找创作者 / 达人 / KOL;涉及受众、话题、平台或市场的问题;核对某位创作者身上到底有哪些已知信息。
• 怎么取数 —— 先查统一检索层,再取完整实体拿证据,而不是只凭检索摘要就作答。
• 怎么读这些字段 —— 推断出来的属性不是已核实的事实;要用上证据、置信度和新鲜度;不知道的地方要说不知道。
• 谁来下判断 —— Koinon 只给候选和证据。推荐是 agent 做的,它要结合用户自己关于产品和这次投放的上下文。

可以这样问

装好之后不需要点名调用任何东西,直接问就行:

• “找一些日本的 AI 领域创作者,他们的受众里有专业软件开发者。”
• “给一个面向东南亚市场的护肤品,找合适的创作者。”
• “对比这几位创作者,告诉我哪些更适合我的产品。”
• “关于这个 TikTok 账号,Koinon 上都知道些什么?哪些是推断的?”

Skill 是怎么工作的

你  →  你的 AI  →  Koinon Skill  →  统一检索层  →  创作者知识图谱

这个 Skill 刻意做得很薄:里面只有使用说明和接口文档,不含任何创作者数据。所有数据都从公开实体、检索 API 或 MCP 现取,你的 AI 读到的就是数据库此刻的内容。

打包一份快照进仓库的话,它从发布当天就开始过期 —— 而"新鲜度"恰恰是我们要求 agent 去依赖的字段之一。把数据打进包里,等于亲手把这个字段作废。

Skill、MCP 和 HTTP API 调的是同一个检索层。它们背后没有第二套排序实现。

安装

这个 Skill 以开放的 Agent Skills 目录形态发布:一个带 frontmatter 的 SKILL.md,加上若干参考文件。任何能从文件夹加载 Agent Skills 的客户端都可以直接用。

Claude Code / Claude Desktop —— 个人 skills 目录

git clone https://github.com/vesselailab/koinonlink ~/.claude/skills/koinon

随项目走(和你的仓库一起提交)

git clone https://github.com/vesselailab/koinonlink .claude/skills/koinon

重启客户端让它重新扫描 skills 目录,然后问一个关于创作者的问题 —— 你应该会看到它去取 koinonlink.com 的数据。

哪些地方能用

我们只描述自己发布的安装方式。某个具体客户端有没有一键安装,是那个客户端自己的事 —— 所以这一节讲的是结构上成立的事实,而不是摆一排 logo。

• 能从文件夹加载 Agent Skills 的客户端 —— 按上面的方式把仓库 clone 到 skills 目录即可,不需要别的。
• 支持 MCP 的客户端 —— 直接指向 Koinon 的 MCP 端点。同一个检索层,不需要装 Skill。
• 其余情况 —— HTTP API 是公开的,无需 key,且开放 CORS。任何能发 GET 请求的东西都能用 Koinon。

claude mcp add --transport http koinon https://koinonlink.com/mcp

在支持的前提下,可以通过 Agent Skills、MCP 或 API 三种方式接入。

源码

这个 Skill 以 CC BY 4.0 开源。装之前建议先读一遍 —— 它很短,而且那就是你的 AI 将要照做的原文。

• https://github.com/vesselailab/koinonlink
• SKILL.md — 指令原文
• references/ — 字段结构、检索方式、证据约定与实例

隐私与数据访问

• Skill 发出去的是你的查询,不是你的数据。一次检索请求里装的是助手从你的问题里提取出的约束条件(话题、平台、受众角色、市场)。
• 无需 key、无需账号、无需注册。因此我们手上没有任何可以把请求挂上去的用户身份。
• 服务器日志。和任何 web 服务一样我们会记录请求。对 AI 流量我们只按天聚合保存 User-Agent、路径和次数 —— 不记 IP,不记任何用户标识。
• 创作者数据都是公开的。Skill 能读到的一切,本来就是本站上的公开 URL。它没有任何特权访问。

想自己接?

Skill 只是门槛最低的那条路,不是唯一一条。同一个检索层可以直接取用:

curl -s "https://koinonlink.com/v1/creator-search?topic=ai%20coding%20tools&platforms=youtube&limit=3"

• 给 AI 系统的完整文档
• MCP 端点(自描述)
• 浏览创作者索引