SuperAPI AI 工具集

npm-downloads-to-leads

通用与其它

查看项目

更新于 10-16 02:27

技能介绍

用途:把 npm 包的下载趋势转化为潜在客户线索,适合寻找增长期开源项目维护者的场景。流程为:输入一个或多个 npm 包名(支持 @org/package 形式的范围包)和可选产品背景;抓取约 13 周每日下载数据并按周聚合,取最近 12 个完整周;计算速度评分,结合近 4 周与前 4 周均值之比、近 2 周加速比,以及对 500 至 50 万周下载量的偏好系数,将包分为爆发、观察、稳态、成熟、太早等层级;仅对爆发和观察层级抓取 npm registry 与 GitHub 用户资料,输出按分数排序的线索简报和个性化触达信息。

主要规则:所有下载数字必须来自 npm API 响应,维护者的 GitHub 用户名或 Twitter 用户名必须来自 GitHub API 响应,不得猜测;若 GitHub 未返回 twitter_username,则写“not found on GitHub”。低于 500 周下载量的包标记为太早,不作为线索。范围包需把 @ 转为 %40,/ 转为 %2F,否则会 404。

使用方式:需设置 GITHUB_TOKEN 以提高 GitHub API 速率限额;不设置时未认证限额约每小时 60 次,约够 10 个包。可先检查 scripts/fetch.py 是否存在,存在则直接运行 python3 scripts/fetch.py PACKAGES_HERE --context "CONTEXT_HERE" --output /tmp/npl-script-out.json;否则运行内联 Python 脚本依次完成抓取、评分与资料补充。脚本会向 /tmp 写入中间 JSON 文件。

限制:GitHub 未认证时速率受限,命中限制时应降级展示速度榜并加数据质量标记,而不是中止;若所有包都 404 或低于 500 周下载量则停止;未提供价格、平台支持等更多信息。