【免费下载链接】skillsBrowser automation CLI built for AI agents. Break through anti-bot walls, hand off to humans across platforms when stuck. Parallel multi-task execution, independent multi-session operation, isolated multi-account browsing.项目地址https://gitcode.com/gh_mirrors/skills31/skills点击查看免费下载导读本文围绕开源仓库 skills 中 GitHub Project Contributor Finder API Skill 展开它面向技术招聘、开发者外联与开源社区运营等场景通过 BrowserAct 的云端工作流 API 自动完成 GitHub 仓库搜索、仓库指标提取与贡献者画像采集。读完本文你将掌握该 Skill 的完整参数体系、命令行调用方式、底层 API 调用链与状态轮询机制并能依据清晰的错误分类与重试策略独立搭建一条从关键词 星级 更新日期到结构化开发者线索的数据流水线。一、技能定位它解决什么问题该 Skill 的核心能力是给定关键词、最低 Star 数与更新日期过滤条件BrowserAct 便会在云端真实浏览器环境中遍历 GitHub 搜索结果、提取仓库指标并进一步抓取贡献者个人资料最终把结构化数据直接通过 API 返回给调用方。用户无需自行编写爬虫脚本也无需处理 GitHub 的限流rate limit问题。仓库 Solutions Catalog 将其归类在Lead Generation线索生成分类下描述为 Find GitHub contributors with contact information与 google-maps-api-skill、social-media-finder-skill 等技能并列共同构成一条面向 B 端线索获取的能力矩阵。五大核心优势继承自原文档无幻觉No Hallucinations预置工作流替代 AI 生成式输出数据提取稳定精确无验证码困扰No Captcha Issues无需自行处理 reCAPTCHA 等验证挑战无 IP 限制No IP Restrictions无需处理地域 IP 限制或地理围栏执行更快Faster Execution相比纯 AI 驱动的浏览器自动化方案任务完成更迅速成本更低Cost-Effective相比高 Token 消耗的 AI 方案显著降低数据采集成本。二、前置准备环境依赖与 API Key运行该 Skill 至少需要两个前提Python 环境中的requests库以及一个有效的 BrowserAct API Key。仓库根目录的 requirements.txt 声明了依赖版本requests2.28.0 python-dotenv1.0.0其中python-dotenv用于从.env文件加载环境变量requests则承担全部 HTTP 调用。安装命令pip install -r requirements.txt关于 API Key原文档明确约定运行前必须检查BROWSERACT_API_KEY环境变量若未设置不要采取其他任何替代措施而是询问并等待用户提供 Key。这一点在源码 github_project_contributor_finder_api.py 中有直接印证——__main__入口通过os.getenv(BROWSERACT_API_KEY)读取密钥缺失时打印引导步骤并sys.exit(1)api_key os.getenv(BROWSERACT_API_KEY) if not api_key: print(\n[!] ERROR: BrowserAct API Key is missing.) print(Please follow these steps:) print(1. Go to: https://www.browseract.com/reception/integrations) print(2. Copy your API Key.) print(3. Provide it to me or set it as an environment variable (BROWSERACT_API_KEY).) sys.exit(1)因此标准的配置方式是在启动前设置环境变量export BROWSERACT_API_KEY你的浏览器控制台获取的Key也可以使用python-dotenv在项目根目录维护.env文件统一管理。Agent 在遇到用户尚未配置 Key 时应明确告知用户前往 BrowserAct 控制台的 Integrations 页面获取 Key然后等待用户提供不得绕过该步骤强行执行。三、输入参数详解五个可调旋钮原文档定义了 5 个输入参数Agent 应根据用户需求灵活配置。下表完整继承原文档的参数说明并补充源码中的类型转换与默认值实现。参数名类型说明示例默认值KeyWordsstring搜索仓库使用的关键词browser automation、react framework、machine learningbrowser automationstarsnumber仓库应达到的最低 Star 数100、1000100updatedstring按最后更新时间过滤仓库格式YYYY-MM-DD2026-01-01、2025-06-012026-01-01Page_Turnsnumber搜索结果列表的翻页数例如共有 39 页而只需前 2 页时传21、21date_limit_per_pagenumber每页搜索结果列表中提取的数据条数5、105在底层实现中这些参数被逐一映射为工作流模板的input_parameters数组字符串型参数原样传递数值型参数统一转为字符串见 github_project_contributor_finder_api.pypayload { workflow_template_id: TEMPLATE_ID, input_parameters: [ {name: KeyWords, value: keywords}, {name: stars, value: str(stars)}, {name: updated, value: updated}, {name: Page_Turns, value: str(page_turns)}, {name: date_limit_per_page, value: str(date_limit_per_page)} ] }而命令行侧则通过sys.argv按位置解析未提供的参数自动落入默认值github_project_contributor_finder_api.pykeywords sys.argv[1] stars int(sys.argv[2]) if len(sys.argv) 2 else 100 updated sys.argv[3] if len(sys.argv) 3 else 2026-01-01 page_turns int(sys.argv[4]) if len(sys.argv) 4 else 1 date_limit_per_page int(sys.argv[5]) if len(sys.argv) 5 else 5由此可见Page_Turns与date_limit_per_page相乘即单次任务的期望数据规模上限例如Page_Turns2、date_limit_per_page10最多可期望约 20 条结果updated作为时间下限过滤条件配合stars可精准圈定近期活跃 高影响力的优质项目。四、调用方式与命令示例原文档规定 Agent 通过执行脚本的方式调用该技能脚本位于scripts/github_project_contributor_finder_api.py。以下命令完整继承自原文档# 完整参数调用关键词、星级、更新日期、翻页数、每页条数 python -u ./scripts/github_project_contributor_finder_api.py browser automation 100 2026-01-01 1 5 # 最小化调用仅指定关键词其余参数使用默认值 python -u ./scripts/github_project_contributor_finder_api.py react framework几点实操要点-u标志强制 Python 的标准输出与错误流为无缓冲模式确保 Agent 能实时读到进度日志脚本开头通过io.TextIOWrapper强制 UTF-8 编码github_project_contributor_finder_api.py避免中英文混合内容在终端出现编码乱码少于 2 个命令行参数即连关键词都没提供时脚本打印 Usage 提示并退出github_project_contributor_finder_api.py。五、底层原理三步式 API 工作流与状态轮询阅读源码可以还原该 Skill 的完整调用链。它本质上是一个提交任务 → 轮询状态 → 拉取结果的三段式异步工作流所有请求都携带Authorization: Bearer api_key请求头服务端基址为https://api.browseract.com/v2/workflow并绑定一个固定工作流模板 IDgithub_project_contributor_finder_api.pyTEMPLATE_ID 90284769428414983 API_BASE_URL https://api.browseract.com/v2/workflow第 1 步启动任务。POST /run-task-by-template携带模板 ID 与输入参数成功返回任务id。若响应中不含id则进入错误分类分支详见下文第六节。第 2 步轮询状态。循环请求GET /get-task-status?task_id{task_id}每次间隔 10 秒整体超时上限 900 秒15 分钟。状态机包含三种终态与两种中间态状态值含义脚本行为finished任务成功完成跳出轮询进入结果拉取failed任务失败打印错误并返回Nonecanceled任务被取消打印错误并返回None其他状态进行中如running继续每 10 秒轮询一次轮询超时超过 900 秒仍未完成打印超时错误并返回None每次轮询都会打印带时间戳的状态日志例如[14:30:05] Task Status: running轮询请求本身发生异常如网络抖动时会打印Polling error后继续重试而不是直接放弃github_project_contributor_finder_api.py。第 3 步拉取结果。任务finished后请求GET /get-task?task_id{task_id}从响应output.string字段取出结构化结果字符串若该字段为空则回退为把整个task_info以 JSON 序列化输出保证数据不丢失github_project_contributor_finder_api.py。这套模板提交 异步轮询的设计是仓库内所有 API 类 Solution 的统一范式例如 social_media_finder.py、google_maps_api.py 均采用相同结构与相同的轮询参数10 秒间隔、900 秒上限说明这是 BrowserAct API Skill 家族的标准工程约定。六、执行监控与判断准则由于任务涉及云端自动化浏览器操作单次执行可能持续数分钟。脚本会在整个生命周期内持续输出带时间戳的状态日志Agent 应遵循以下准则完整继承自原文档持续观察终端输出不要离开只要不断出现新的状态日志就说明任务在正常运行切勿误判为卡死仅当状态长时间不变、或输出停止且迟迟没有最终结果时才考虑触发重试。这一判断准则与源码的 900 秒轮询上限相互呼应Agent 观察到的最长无声窗口约为 10 秒两次轮询间隔若远超该窗口仍无任何新日志才需要怀疑任务异常。七、数据输出字段说明执行成功后脚本会解析 API 响应并打印结构化结果。原文档将输出分为两组字段全部继承如下仓库字段Project Fieldsrepository_nameGitHub 仓库名称repository_url仓库 URL 链接repository_owner_name仓库所有者/创建者repository_description仓库简介star_count仓库获得的 Star 数。贡献者字段Contributor Fieldsuser_name贡献者的 GitHub 用户名profile_url贡献者个人主页链接bio贡献者的个人简介repositories_summary贡献者拥有的其他仓库摘要personal_website贡献者个人网站链接twitter贡献者的 Twitter 账号。这两组字段的组合价值在于仓库字段用于筛选与评估项目影响力Star 数与描述贡献者字段则直接产出可用于外联的人的线索主页、个人网站、Twitter、简介恰好对应技术招聘与开发者营销的两类核心需求。输出字符串由output.string承载github_project_contributor_finder_api.py结构上适合直接交给 Agent 做进一步的结构化解析或入库。八、错误处理与重试策略原文档给出了明确的错误分类处理逻辑Agent 必须按此执行该逻辑在源码 github_project_contributor_finder_api.py 中亦有完整实现两者完全对应。第 1 步检查输出内容进行分类若输出包含Invalid authorization说明 API Key 无效或已过期。不要重试引导用户重新检查并提供正确的 Key。源码对应分支为if Invalid authorization in res_str: print(Error: Invalid authorization. Please check your BrowserAct API Key., flushTrue)若输出包含concurrent或too many running tasks说明已达并发任务上限。不要重试引导用户升级套餐。Agent 应明确告知用户当前任务无法执行因为你的 BrowserAct 账户已达到并发任务上限请前往 BrowserAct 套餐升级页面升级你的套餐。源码对应分支为elif concurrent in res_str.lower() or too many running tasks in res_str.lower(): print(Error: Concurrent task limit reached. Please upgrade your plan ..., flushTrue)注意这里对concurrent做了.lower()大小写归一化处理匹配更稳健若输出不包含上述错误关键词但任务确实失败例如输出以Error:开头或返回空结果Agent 应自动重新执行脚本一次。这类情况通常对应网络波动、Connection to API failed、任务failed/canceled、轮询超时等临时性故障。第 2 步重试次数限制。自动重试仅限1 次若第二次尝试仍失败停止重试将具体错误信息报告给用户等待人工介入。九、典型应用场景原文档列出了 10 个典型使用场景完整继承如下技术招聘Tech Recruiting从热门仓库聚合贡献者画像与社交链接构建候选人渠道开源发现Open-Source Discovery按关键词与 Star 数检索热门仓库发掘高价值项目开发者外联Developer Outreach收集活跃贡献者的个人网站与 Twitter用于开发者工具营销社区建设Community Building识别并连接特定领域的活跃开源贡献者竞品分析Competitor Analysis监控哪些开发者在为竞品项目做贡献合作探索Partnership Scouting为潜在合作或赞助寻找仓库所有者市场研究Market Research分析仓库指标与描述理解技术趋势线索生成Lead Generation通过匹配相关技术栈的项目为开发者工具生成精准线索学术研究Academic Research发现特定研究领域中近期更新的仓库人才画像Talent Mapping基于 GitHub 贡献与个人资料构建开发者数据库。这些场景的共同点在于都依赖项目维度关键词 × 星级 × 活跃度与人物维度主页、Twitter、个人网站的交叉检索而这正是本 Skill 输出的两组字段所天然支撑的。十、延伸阅读本 Skill 属于仓库 Solutions Catalog 中 Lead Generation 分类的一员同分类下还提供 google-maps-api-skill地图商家数据采集、social-media-finder-skill按人名找社交账号、industry-key-contact-radar-api-skill跨行业关键联系人雷达等技能可组合成更完整的线索获取闭环。所有 Solution 均由 Skill Forge 生成、以 BrowserAct API 为底座结构与本文剖析的提交 → 轮询 → 拉取三步范式保持一致掌握本文即可举一反三。需要说明的是本技能为云端 API 驱动型 Skill运行时依赖BROWSERACT_API_KEY与 BrowserAct 云端工作流服务且受账户并发上限约束在接入自有 Agent 流程时应结合 docs/skills.md 所述的两层 Skill 架构与 README.md 中关于并发隔离、会话管理的约定将本技能正确挂载到 Agent 的技能发现与调用链路中。赞分享【免费下载链接】skillsBrowser automation CLI built for AI agents. Break through anti-bot walls, hand off to humans across platforms when stuck. Parallel multi-task execution, independent multi-session operation, isolated multi-account browsing.项目地址https://gitcode.com/gh_mirrors/skills31/skills点击查看免费下载相关推荐BrowserAct Industry Key Contact Radar API Skill 实战指南跨平台关键联系人发现与线索挖掘BrowserAct Industry Key Contact Radar API Skill 实战指南跨平台关键联系人发现与线索挖掘 导读 本指南以 BroBrowserAct Skills 仓库 youtube-api-skill 实战指南基于关键词批量提取 YouTube 视频指标与频道数据BrowserAct Skills 仓库 youtube api skill 实战指南基于关键词批量提取 YouTube 视频指标与频道数据 导读 本指南围绕GitHub项目贡献指南基于go-github的贡献者系统GitHub项目贡献指南基于go github的贡献者系统 贡献者的痛点与解决方案 你是否曾在开源项目贡献中遇到以下问题 不知如何开始贡献流程被复杂的仓库后端API设计上一篇2024年必学WPF工具CalcBinding让路径表达式绑定变得如此简单下一篇Cuckoo Filter源码解析从Insert到Delete的实现细节创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考