全部作品
2026已交付工具
探迹本地客户端
tanji-client
探迹 AI 拓客的本地客户端:一个常驻 owner、多账号会话、可度量的缓存。
- 角色
- 设计与开发(独立)
- 年份
- 2026
- 状态
- 已交付
- 技术栈
- TypeScriptMCPSQLitesystemd
探迹在浏览器里很强,在程序里很难:登录依赖 SSO cookie,频繁请求会触发限频,页面接口会变,多个脚本共用一个账号还会互相抢浏览器 profile。
问题
探迹是按额度计费的。查企业、看工商、股东、主要人员,解锁联系方式都要花额度。手工在网页里查又慢又容易把额度花在无效客户上。我需要一个能缓存、能限频、能被 Agent 调用的本地接口,同时不要把账号搞挂。
做法
tanji-client 把这些问题收敛成一个本地 owner 进程:一个浏览器、一个 REST 服务、一套缓存和限频。其他进程(CLI、MCP、脚本)只通过本地 REST 调用,不会各自去开浏览器。
多账号:每个账号独立 profile、缓存和端口。MCP 默认只代理到 REST,不持有 profile,所以「already running」的锁问题消失。
架构要点
- 筛选是数据不是表单:12 个类别、345 条高级筛选条件做成注册表,接受筛选文件,高级筛选于是变成数据问题。
- 限频是产品设计:企业详情支持轻量模式(只取基础与详情段)省调用;解锁默认只打 1 个上游调用;限频分 priority(解锁、登录)和 bulk(批量读)两条通道,长批处理不会堵住解锁。
- 缓存:cache-aside + TTL,命中约 1–2ms,另有清理命令,需要真相时用。
- 登录:处理「账号中心还登录、sales 会话失效」的中间态,验证码走可见浏览器兜底。
- 运维:systemd 常驻、多账号启动、日志轮转、健康检查。
学到什么
多账号系统首先是隔离问题,其次才是功能问题。限频应该和 API 一起设计,而不是等第一个账号被限之后再补。
还有一点是诚实:README 里写清楚真实限制——缓存没有 LRU、部分缓存 key 没纳入排序、解锁会消耗额度所以必须显式确认。写出来之后,用的人反而更放心。
59 个测试、13 个 MCP 工具、345 条筛选条件。这个项目用的许可证是 Unlicense(公共领域)。