跳到主要内容

从这里开始

AgentWIFI 使用指南

想让 Agent 查资料、看评论或跟踪趋势?先选一种使用方式,跟着做一次。需要接口细节时,继续往下查。

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 获取完整列表。

按用途找工具

这里列出当前发布的工具。有些工具可能暂时无法调用;真正使用前,请再确认状态、需要的输入和费用。

按工具类别筛选
找到 231 项
  • 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 Key

Key 可以做什么

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 联系我们。
AgentWIFI 文档 | AgentWIFI