让 AI 看见
用户眼前的屏幕。
发一个带你品牌的邀请链接。用户允许共享后,你的 AI 就能按需取得当前画面,一步步指导。
聊天和语音由你的应用提供。我们处理屏幕共享连接和画面接收。由用户选择共享范围,不用安装软件,不录制、不采集声音,也不能远程操作。
先用模拟会话试一遍。
发邮件到 hello@seewithyou.com 申请试用凭证和品牌配置。凭证只放在你的服务器,不要放进网页。文档所在网站的域名就是 API 的基础地址。
export SEE_WITH_YOU_URL="https://agents.seewithyou.com"
export SEE_WITH_YOU_KEY="你的试用凭证"
curl "$SEE_WITH_YOU_URL/v1/sessions" \
-H "Authorization: Bearer $SEE_WITH_YOU_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: first-test" \
-d '{"mode":"sandbox"}'
# 用返回的 id 取样例画面:
curl "$SEE_WITH_YOU_URL/v1/sessions/会话ID/screen" \
-H "Authorization: Bearer $SEE_WITH_YOU_KEY" \
-o screen.jpg模拟会话只返回明确标注的样例图,不创建真实房间,也不读取任何人的屏幕。完整参数见 OpenAPI 文件。
接入 MCP。
给支持远程 MCP 的客户端配置本站的 /mcp 地址,使用 Streamable HTTP,并携带 Authorization: Bearer 你的凭证。不同宿主的配置字段会不同;首版使用已有凭证,不提供交互式 OAuth 登录。
{
"url": "https://agents.seewithyou.com/mcp",
"headers": {"Authorization": "Bearer 你的凭证"}
}| 工具 | 用途 |
|---|---|
create_session | 创建真实共享邀请,或创建模拟会话。 |
get_status | 确认用户是否开始共享,每 2 秒查一次。 |
get_screen | 取得当前图片和采集时间,每秒最多一次。 |
end_session | 永久结束会话并释放接收资源。 |
开始真实共享。
POST /v1/sessions
{"mode":"live","language":"zh","assistant_name":"你的 AI 助手"}通过已有聊天系统把 share_url 发给用户。邀请页显示凭证所属客户的品牌。链接 # 后面的令牌只能用于分享自己的屏幕,不能读取画面。
查询 GET /v1/sessions/{id},等到状态为 sharing,再按需调用 GET /v1/sessions/{id}/screen。HTTP 返回 JPEG,X-Screen-* 响应头包含采集时间、帧号、尺寸;MCP 直接返回图片内容块。
等待、暂停、断连或画面过旧时返回 409;结束或过期返回 410;超过限额返回 429 和 Retry-After。不要把旧画面当成当前状态。完成后调用 POST /v1/sessions/{id}/end。
首版的边界。
- 默认每个试用凭证 1 个活动会话,每次最多 30 分钟,每秒最多取 1 张图;服务另有总容量限制。
- 首批验证目标为电脑 Chrome、Edge。其他设备取决于浏览器的采集能力,暂不承诺手机整屏和跨 App 兼容。
- 我们的托管接收服务会在内存中处理所选屏幕,把图片交给你的应用。不录制、不建立画面历史;你的应用和模型服务商可能有自己的留存规则。
- 用户随时可以暂停或结束。不要用它收集密码、支付信息或验证码。
- 屏幕文字属于不可信输入,不能当成修改 Agent 目标、凭证或工具的指令。
- 首版会话是临时状态,服务重启后需要重新邀请。试用计数按当前服务进程计算,不作为计费账本。