用途:在动手做项目前,用真实数据核查某个项目想法是否已有人做过、领域成熟度如何、机会在哪里。它借助 TinyFish CLI(命令行浏览器自动化工具)搜索 GitHub 仓库与 Dev.to 文章,再综合成差距分析。
使用前检查(两项都必须先通过):
- 是否安装 CLI:PowerShell 用 Get-Command tinyfish; tinyfish --version;bash/zsh 用 which tinyfish && tinyfish --version || echo "TINYFISH_CLI_NOT_INSTALLED"。未安装则提示 npm install -g @tiny-fish/cli。
- 是否已认证:tinyfish auth status。未认证需在 https://agent.tinyfish.ai/api-keys 获取 API key,再选择:tinyfish auth login;或 PowerShell 会话内 $env:TINYFISH_API_KEY="your_api_key_here";或写进用户环境变量;或 bash/zsh 用 export;或写入 ~/.claude/settings.local.json 的 env。
主要能力与步骤:核心命令为 tinyfish agent run --url <url> "<goal>",支持 --sync、--async、--pretty。先搜索 GitHub 仓库(如按星数排序的搜索结果页),用 --sync 提取名称、owner、描述、星数、URL、最近更新等 JSON;再搜索 Dev.to 文章,提取标题、作者、标签、发布时间、URL、reactions。两个来源互相独立,应并行执行,不要串行等待。随后依据两者的原始 JSON 综合成差距分析,结构为:已存在什么、成熟度评估(GitHub 活跃/废弃/碎片化;Dev.to 覆盖度)、差距与机会、结论。
关键词策略:结果质量取决于检索词。每个想法预先派生 2–3 组关键词变体;若首轮结果稀少,可对每个变体再跑并行调用。
管理运行:tinyfish agent run list、tinyfish agent run get <run_id>、tinyfish agent run cancel <run_id>。
输出说明:CLI 默认以 SSE 行流式返回,最终结果为 type == "COMPLETE" 且 status == "COMPLETED" 的事件,提取数据在 resultJson 字段,直接读取即可。限制:只能使用 TinyFish 实际返回的数据,不得编造仓库名、星数或文章标题;API key、认证方式与平台能力以官方资料为准,其他细节暂未提供。