01 · 01
先把 AgentWIFI 接入你的 Agent
接好之后,你照常用对话提出任务。Agent 可以通过 AgentWIFI 找工具、查看费用,再获取结果。
步骤 1 / 3
把安装请求发给 Agent
复制下面这句话,发给你正在使用的 Agent。它会阅读官方安装指南,检查你的客户端和系统,并选择对应的接入方式。提示词发出去后,还要留意下面的授权和客户端确认步骤。
Read https://agentwifi.ai/install.md and install AgentWIFI for this agent only.步骤 2 / 3
完成授权和客户端确认
Agent 可能打开浏览器登录页,也可能给你一个授权网址和一次性代码。按照它显示的步骤,在浏览器里亲自完成授权;不需要把 API Key 发到聊天中。不同客户端还可能有最后一步:
如果你用 Codex
走原生 MCP 登录时,Codex 会打开浏览器。登录 AgentWIFI 并确认授权,再回到 Codex。如果只看到“已添加”却没有完成登录,让 Codex 继续执行 AgentWIFI 登录。若走安装器,则按它给出的网址和一次性代码授权。
如果你用 WorkBuddy
完成安装器的浏览器授权后,打开 WorkBuddy → 点击左上角「专家·技能·连接器」→ 点击「连接器」→ 点击右上角「自定义连接器」→ 找到安装器已添加的 AgentWIFI,点击“信任”。如果已经显示“已信任”,直接继续。这一步必须由你在 WorkBuddy 中完成;然后新建任务或重载窗口。
使用其他 Agent?按安装指南和客户端提示完成授权,然后重新打开会话。安装完成不代表旧会话会立即看到新工具。
步骤 3 / 3
新开会话,试一个任务
完成授权,以及客户端要求的信任操作后,新建对话或任务。下面这句话可以直接复制进去,不用记住工具名。
请用 AgentWIFI 找几条最近的 AI 新闻。先看看要用的工具和费用,再开始搜索,最后附上新闻来源。如果 Agent 返回了带来源的搜索结果,就说明可以使用。若它提示找不到 AgentWIFI 工具:Codex 先检查浏览器或安装器授权,WorkBuddy 先检查连接器是否已信任;其他客户端按安装指南检查连接,再新开会话。
01 · 02
哪些 Agent 可以接入
下面这些客户端已有安装流程。不同客户端的步骤略有不同,具体做法请看安装指南。
使用 Codex、Claude Code、Gemini CLI 或 Kimi CLI 时,可以先试浏览器授权;其他列出的客户端可按安装指南完成设备授权。
支持的 Agent
- Codex
- Claude Code
- Cursor
- Gemini CLI
- OpenCode
- OpenClaw
- Hermes
- Qoder
- WorkBuddy
- Kimi CLI
- Kiro
- Windsurf
- ZCode
覆盖的系统: macOS、Linux、Windows
没看到你用的 Agent?先在安装指南里确认它是否受支持,再动手配置。
01 · 03
找到要用的工具
这里收录了网页、社交媒体、电商等不同用途的工具。先按任务找一找,再看它的名称和计费方式。
先用类别和搜索框缩小范围,再点“再看几项”继续浏览。如果你在写程序,也可以通过 REST API 获取完整列表。
按用途找工具
这里列出当前发布的工具。有些工具可能暂时无法调用;真正使用前,请再确认状态、需要的输入和费用。
Google Trends 趋势研究
web.seo.google_trends
网页与搜索 · 4 credits / 条结果
Keyword Planner 关键词指标
web.seo.keyword_planner.get_metrics
网页与搜索 · 13 credits / 条结果
Keyword Planner 关键词建议
web.seo.keyword_planner.get_ideas
网页与搜索 · 13 credits / 条结果
Keyword Planner 指标或建议
web.seo.keyword_planner
网页与搜索 · 13 credits / 条结果
Ahrefs 网站权威度
web.seo.ahrefs.get_web_authority
网页与搜索 · 11 credits / 条结果
Ahrefs 网站流量
web.seo.ahrefs.get_traffic
网页与搜索 · 11 credits / 条结果
Ahrefs AI 概览
web.seo.ahrefs.get_ai_overview
网页与搜索 · 11 credits / 条结果
Ahrefs AI Mode
web.seo.ahrefs.get_ai_mode
网页与搜索 · 11 credits / 条结果
在 Agent 里怎么用
把目标说清楚就好。例如“读一下这个网页,提炼要点”。Agent 应先找合适的工具,查看输入要求、费用和可用状态,再执行。如果结果有下一页,也可以让它继续读取。
请用 AgentWIFI 帮我读一个网页。先告诉我需要提供什么、会花多少 credits,再向我要链接,并把页面要点整理出来。01 · 04
用 Skill 处理常见任务
Skill 是给 Agent 的任务指南。它把一类任务的操作步骤写好,例如整理商品评价、查看热榜或比较价格。
Skill 帮你省什么
你不用自己安排每一步。Skill 会告诉 Agent 先问你哪些信息、要调用哪些工具、最多查多少条,以及结果该怎么整理。它使用的仍是 AgentWIFI 的能力。
怎么开始
先把 AgentWIFI 接入 Agent,再说出你想用的 Skill。Agent 会读取商店里的指南;如果这个 Skill 需要本地文件,再按商店说明安装。开始前,先确认需要提供的信息、费用和条数上限。
帮我用 AgentWIFI 的 amazon-review-digest Skill 整理一件亚马逊商品的评价。先告诉我需要什么、预计费用和最多会看多少条,再向我要 ASIN。ASIN 是亚马逊商品编号;其他 Skill 可能需要不同的信息。
目前可以使用的 Skill
下面是当前发布的列表。到 Skill 商店可查看每项的详细说明和安装方式。
AgentWIFI Reddit Monitor
按关键词监测 Reddit 讨论,去重并整理机会线索。
agentwifi-reddit-monitor· 本地安装AgentWIFI Brand Mention Tracking
追踪品牌或竞品在公开社交渠道的直接提及。
agentwifi-track-brand-mentions· 本地安装Amazon Review Digest
按 ASIN 汇总亚马逊商品评价和优缺点。
amazon-review-digest· 直接加载Bilibili Hot Videos
查看 B 站当前热搜话题。
bilibili-hot-videos· 直接加载Douyin Hot Trends
查看抖音热搜或总榜。
douyin-hot-trends· 直接加载Multi-Platform Price Compare
比较同一商品在多个电商平台的价格。
multi-platform-price-compare· 直接加载Reddit Hot Posts
获取 Reddit 当前热门帖子。
reddit-hot-posts· 直接加载TikTok Trending Scan
获取 TikTok 热门搜索词。
tiktok-trending-scan· 直接加载WeChat Article Research
检索公众号文章并提炼摘要。
wechat-article-research· 直接加载Weibo Hot Search
获取微博实时热搜。
weibo-hot-search· 直接加载Xiaohongshu Daily Trending
查看小红书热榜与热门话题。
xiaohongshu-daily-trending· 直接加载Xiaohongshu Note Comments
分析公开小红书笔记下的评论观点。
xiaohongshu-note-comments· 直接加载
01 · 05
通过 MCP 让 Agent 使用 AgentWIFI
MCP 是 Agent 连接工具的一种方式。接入后,Agent 可以查找工具、查看费用并发起调用。支持浏览器授权的客户端使用 https://mcp.agentwifi.ai/v1/mcp;手动配置 API Key 时使用 https://agentwifi.ai/v1/mcp。
一次调用是怎么完成的
比如你说“帮我读这篇文章”,Agent 会先找能读取网页的工具(find_tools),查看输入要求和费用(describe_tool),再调用它(execute_tool)。你也可以在自己的客户端里按这个顺序调用。
接入后可以使用的工具
02
什么时候需要 API Key
如果你自己写脚本或服务来调用 AgentWIFI,就需要 API Key。只是在 Agent 里使用、并通过浏览器完成授权,通常不用自己创建。
用在什么地方
在服务端脚本、定时任务或需要手动配置的 MCP 客户端中使用。把 Key 存在服务端,并在请求头中传入 Authorization: Bearer YOUR_API_KEY;不要放进网页代码或聊天消息。
创建并保管 Key
到控制台创建 Key,只授予这次调用需要的权限。保存好创建的 Key;不再使用或发现泄露时,回到同一页面撤销。
去创建 API KeyKey 可以做什么
- catalog:read
- 查找工具,并查看它们的用法
- account:read
- 查看余额和能力状态
- tools:execute
- 调用当前可用的工具
MCP 和 REST 的调用都会计入同一个 credits 余额,也可以在调用记录中追查。更换 Key 时,先更新你的程序,再撤销旧 Key。
先用这条请求检查 Key
curl --fail-with-body --silent --show-error 'https://agentwifi.ai/v1/account' \
--header 'Authorization: Bearer <YOUR_API_KEY>'03
在程序中调用 REST API
自己写脚本或后端服务时,可以用 HTTP 请求完成工具搜索、账户查询和调用。先创建 API Key,再从下面的端点和示例开始。
复制一条请求试试
先找工具
curl --fail-with-body --silent --show-error 'https://agentwifi.ai/v1/catalog/search?query=latest%20AI%20news&limit=3' \
--header 'Authorization: Bearer <YOUR_API_KEY>'再调用工具
curl --fail-with-body --silent --show-error 'https://agentwifi.ai/v1/execute' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--request POST \
--header 'Content-Type: application/json' \
--data '{"canonicalName":"web.search","params":{"query":"latest AI news"},"maxCredits":"1","idempotencyKey":"docs-web-search-001"}'04
出错时怎么处理
先找到返回的错误码,按下面的提示检查。反馈问题时,请附上响应中的请求 ID(X-Request-Id),方便定位这次调用。
{
"error": {
"code": "RATE_LIMITED",
"message": "Request rate limit exceeded",
"retryAfterMs": 1000,
"scope": "api_key_rate"
},
"requestId": "req_example_01"
}- VALIDATION_ERROR400
- 有参数没填对。查看返回的 fieldErrors,找到具体字段后再试。
- UNAUTHENTICATED401
- 没有提供 API Key,或 Key 已失效。检查配置;需要时在控制台重新创建。
- INSUFFICIENT_CREDITS402
- credits 余额不够。到控制台查看余额并充值。
- FORBIDDEN403
- 当前 Key 没有这项权限。创建一个包含所需权限的新 Key。
- NOT_FOUND404
- 找不到这个工具或资源。先搜索一次,核对工具名称。
- TOOL_UNAVAILABLE409
- 这个工具目前无法调用。稍后再试,或找一个能完成同样任务的工具。
- RATE_LIMITED429
- 请求太频繁。查看 retryAfterMs,等待指定时间后再试。
- CANCELLED499
- 请求已被客户端取消。如果还需要结果,请重新发起。
- UPSTREAM_TIMEOUT504
- 数据来源响应超时。稍后再试。
- UPSTREAM_UNAVAILABLE502
- 数据来源暂时不可用。系统会尝试备用渠道;仍失败时请稍后再试。
- CATALOG_UNAVAILABLE503
- 工具目录暂时无法读取。稍后再试。
- DEADLINE_EXCEEDED504
- 这次请求用时过长。缩小任务范围后再试。
- INTERNAL_ERROR500
- 服务端出了问题。请附上请求 ID 联系我们。