Slack自动化指南：使用Vercel Labs Agent-Browser检查消息、提取数据与任务自动化

slack by vercel-labs/agent-browser

8,800 周安装量

25,100 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vercel-labs/agent-browser --skill slack

开发监控生产力

🇨🇳中文介绍

Slack 自动化

与 Slack 工作区交互，以检查消息、提取数据并自动化常见任务。

快速开始

连接到现有的 Slack 浏览器会话或打开 Slack：

# 连接到端口 9222 上的现有会话（适用于已打开的 Slack）
agent-browser connect 9222

# 或者，如果 Slack 未运行，则打开它
agent-browser open https://app.slack.com

然后拍摄快照以查看可用的内容：

agent-browser snapshot -i

核心工作流程

连接/导航 : 打开或连接到 Slack
快照 : 获取带有引用（@e1、@e2 等）的交互元素
导航 : 点击选项卡、展开部分或导航到特定频道
提取/交互 : 读取数据或执行操作
截图 : 捕获发现结果的证据

# 示例：检查未读频道

agent-browser connect 9222
agent-browser snapshot -i
# 查找“更多未读”按钮
agent-browser click @e21  # “更多未读”按钮的引用
agent-browser screenshot slack-unreads.png

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

记录笔记/捕获状态

当您需要记录 Slack 中的发现时：

# 拍摄带注释的截图（显示元素编号）
agent-browser screenshot --annotate slack-state.png

# 拍摄整页截图
agent-browser screenshot --full slack-full.png

# 获取当前 URL 以供参考
agent-browser get url

# 获取页面标题
agent-browser get title

了解 Slack 的侧边栏有助于您高效导航：

- Threads
- Huddles
- Drafts & sent
- Directories
- [Section Headers - External connections, Starred, Channels, etc.]
  - [Channels listed as treeitems]
- Direct Messages
  - [DMs listed]
- Apps
  - [App shortcuts]
- [More unreads] button (toggles unread channels list)

需要查找的关键引用：

@e12 - 主页选项卡（通常）
@e13 - 私信选项卡
@e14 - 活动选项卡
@e5 - 搜索按钮
@e21 - 更多未读按钮（因会话而异）

Slack 中的选项卡

点击频道后，您会看到以下选项卡：

消息 - 频道对话
文件 - 共享文件
置顶 - 置顶消息
添加画布 - 协作画布
其他选项卡取决于工作区设置

点击选项卡引用以切换视图并获取不同的信息。

从 Slack 提取数据

# 获取消息或元素的文本
agent-browser get text @e_message_ref

解析无障碍功能树

# 将完整快照保存为 JSON 以便进行程序化解析
agent-browser snapshot --json > output.json

# 查找：
# - 频道名称（treeitem 中的 name 字段）
# - 消息内容（在 listitem/document 元素中）
# - 用户名（包含用户信息的 button 元素）
# - 时间戳（包含时间信息的 link 元素）

# 展开未读部分后：
agent-browser snapshot -i | grep -c "treeitem"
# 未读部分中每个带有频道名称的 treeitem 代表一个未读项

连接到现有会话 : 如果 Slack 已打开，请使用 agent-browser connect 9222。这比打开新浏览器更快。
点击前拍摄快照 : 在点击按钮之前，始终使用 snapshot -i 来识别引用。
导航后重新拍摄快照 : 导航到新频道或部分后，拍摄新的快照以查找新的引用。
使用 JSON 快照进行解析 : 当您需要提取结构化数据时，使用 snapshot --json 获取机器可读的输出。
控制交互节奏 : 在快速交互之间添加 sleep 1，让 UI 有时间更新。
检查无障碍功能树 : 无障碍功能树显示了屏幕阅读器（以及您的自动化工具）可以看到的内容。如果快照中没有某个元素，它可能被隐藏或需要滚动才能看到。
在侧边栏中滚动 : 如果频道列表很长，请使用 agent-browser scroll down 300 --selector ".p-sidebar" 在 Slack 侧边栏内滚动。

无法访问 Slack API : 这使用浏览器自动化，而非 Slack API。不需要 OAuth、webhooks 或机器人令牌。
会话特定 : 截图和快照与当前浏览器会话绑定。
速率限制 : Slack 可能会对快速交互进行速率限制。如果需要，请在命令之间添加延迟。
工作区特定 : 您与自己的工作区交互——没有跨工作区的自动化。

检查控制台错误

agent-browser console
agent-browser errors

获取当前页面状态

agent-browser get url
agent-browser get title
agent-browser screenshot page-state.png

示例：完整的未读检查

#!/bin/bash

# 连接到 Slack
agent-browser connect 9222

# 拍摄初始快照
echo "=== Checking Slack unreads ==="
agent-browser snapshot -i > snapshot.txt

# 检查活动选项卡中的未读内容
agent-browser click @e14  # 活动选项卡
agent-browser wait 1000
agent-browser screenshot activity.png
ACTIVITY_RESULT=$(agent-browser get text @e_main_area)
echo "Activity: $ACTIVITY_RESULT"

# 检查私信
agent-browser click @e13  # 私信选项卡
agent-browser wait 1000
agent-browser screenshot dms.png

# 检查侧边栏中的未读频道
agent-browser click @e21  # 更多未读按钮
agent-browser wait 500
agent-browser snapshot -i > unreads-expanded.txt
agent-browser screenshot unreads.png

# 摘要
echo "=== Summary ==="
echo "See activity.png, dms.png, and unreads.png for full details"

Slack 文档 : https://slack.com/help
Web 体验 : https://app.slack.com
键盘快捷键 : 在 Slack 中键入 ? 查看快捷键列表

🇺🇸English

Slack Automation

Interact with Slack workspaces to check messages, extract data, and automate common tasks.

Quick Start

Connect to an existing Slack browser session or open Slack:

# Connect to existing session on port 9222 (typical for already-open Slack)
agent-browser connect 9222

# Or open Slack if not already running
agent-browser open https://app.slack.com

Then take a snapshot to see what's available:

agent-browser snapshot -i

Core Workflow

Connect/Navigate : Open or connect to Slack
Snapshot : Get interactive elements with refs (@e1, @e2, etc.)
Navigate : Click tabs, expand sections, or navigate to specific channels
Extract/Interact : Read data or perform actions
Screenshot : Capture evidence of findings

# Example: Check unread channels

agent-browser connect 9222
agent-browser snapshot -i
# Look for "More unreads" button
agent-browser click @e21  # Ref for "More unreads" button
agent-browser screenshot slack-unreads.png

Common Tasks

Checking Unread Messages

# Connect to Slack
agent-browser connect 9222

# Take snapshot to locate unreads button
agent-browser snapshot -i

# Look for:
# - "More unreads" button (usually near top of sidebar)
# - "Unreads" toggle in Activity tab (shows unread count)
# - Channel names with badges/bold text indicating unreads

# Navigate to Activity tab to see all unreads in one view
agent-browser click @e14  # Activity tab (ref may vary)
agent-browser wait 1000
agent-browser screenshot activity-unreads.png

# Or check DMs tab
agent-browser click @e13  # DMs tab
agent-browser screenshot dms.png

# Or expand "More unreads" in sidebar
agent-browser click @e21  # More unreads button
agent-browser wait 500
agent-browser screenshot expanded-unreads.png

Navigating to a Channel

# Search for channel in sidebar or by name
agent-browser snapshot -i

# Look for channel name in the list (e.g., "engineering", "product-design")
# Click on the channel treeitem ref
agent-browser click @e94  # Example: engineering channel ref
agent-browser wait --load networkidle
agent-browser screenshot channel.png

Finding Messages/Threads

# Use Slack search
agent-browser snapshot -i
agent-browser click @e5  # Search button (typical ref)
agent-browser fill @e_search "keyword"
agent-browser press Enter
agent-browser wait --load networkidle
agent-browser screenshot search-results.png

Extracting Channel Information

# Get list of all visible channels
agent-browser snapshot --json > slack-snapshot.json

# Parse for channel names and metadata
# Look for treeitem elements with level=2 (sub-channels under sections)

Checking Channel Details

# Open a channel
agent-browser click @e_channel_ref
agent-browser wait 1000

# Get channel info (members, description, etc.)
agent-browser snapshot -i
agent-browser screenshot channel-details.png

# Scroll through messages
agent-browser scroll down 500
agent-browser screenshot channel-messages.png

Taking Notes/Capturing State

When you need to document findings from Slack:

# Take annotated screenshot (shows element numbers)
agent-browser screenshot --annotate slack-state.png

# Take full-page screenshot
agent-browser screenshot --full slack-full.png

# Get current URL for reference
agent-browser get url

# Get page title
agent-browser get title

Sidebar Structure

Understanding Slack's sidebar helps you navigate efficiently:

- Threads
- Huddles
- Drafts & sent
- Directories
- [Section Headers - External connections, Starred, Channels, etc.]
  - [Channels listed as treeitems]
- Direct Messages
  - [DMs listed]
- Apps
  - [App shortcuts]
- [More unreads] button (toggles unread channels list)

Key refs to look for:

@e12 - Home tab (usually)
@e13 - DMs tab
@e14 - Activity tab
@e5 - Search button
@e21 - More unreads button (varies by session)

Tabs in Slack

After clicking on a channel, you'll see tabs:

Messages - Channel conversation
Files - Shared files
Pins - Pinned messages
Add canvas - Collaborative canvas
Other tabs depending on workspace setup

Click tab refs to switch views and get different information.

Extracting Data from Slack

Get Text Content

# Get a message or element's text
agent-browser get text @e_message_ref

Parse Accessibility Tree

# Full snapshot as JSON for programmatic parsing
agent-browser snapshot --json > output.json

# Look for:
# - Channel names (name field in treeitem)
# - Message content (in listitem/document elements)
# - User names (button elements with user info)
# - Timestamps (link elements with time info)

Count Unreads

# After expanding unreads section:
agent-browser snapshot -i | grep -c "treeitem"
# Each treeitem with a channel name in the unreads section is one unread

Best Practices

Connect to existing sessions : Use agent-browser connect 9222 if Slack is already open. This is faster than opening a new browser.
Take snapshots before clicking : Always snapshot -i to identify refs before clicking buttons.
Re-snapshot after navigation : After navigating to a new channel or section, take a fresh snapshot to find new refs.
Use JSON snapshots for parsing : When you need to extract structured data, use snapshot --json for machine-readable output.
Pace interactions : Add sleep 1 between rapid interactions to let the UI update.
Check accessibility tree : The accessibility tree shows what screen readers (and your automation) can see. If an element isn't in the snapshot, it may be hidden or require scrolling.
Scroll in sidebar : Use agent-browser scroll down 300 --selector ".p-sidebar" to scroll within the Slack sidebar if channel list is long.

Limitations

Cannot access Slack API : This uses browser automation, not the Slack API. No OAuth, webhooks, or bot tokens needed.
Session-specific : Screenshots and snapshots are tied to the current browser session.
Rate limiting : Slack may rate-limit rapid interactions. Add delays between commands if needed.
Workspace-specific : You interact with your own workspace -- no cross-workspace automation.

Debugging

Check console for errors

agent-browser console
agent-browser errors

Get current page state

agent-browser get url
agent-browser get title
agent-browser screenshot page-state.png

Example: Full Unread Check

#!/bin/bash

# Connect to Slack
agent-browser connect 9222

# Take initial snapshot
echo "=== Checking Slack unreads ==="
agent-browser snapshot -i > snapshot.txt

# Check Activity tab for unreads
agent-browser click @e14  # Activity tab
agent-browser wait 1000
agent-browser screenshot activity.png
ACTIVITY_RESULT=$(agent-browser get text @e_main_area)
echo "Activity: $ACTIVITY_RESULT"

# Check DMs
agent-browser click @e13  # DMs tab
agent-browser wait 1000
agent-browser screenshot dms.png

# Check unread channels in sidebar
agent-browser click @e21  # More unreads button
agent-browser wait 500
agent-browser snapshot -i > unreads-expanded.txt
agent-browser screenshot unreads.png

# Summary
echo "=== Summary ==="
echo "See activity.png, dms.png, and unreads.png for full details"

References

Slack docs : https://slack.com/help
Web experience : https://app.slack.com
Keyboard shortcuts : Type ? in Slack for shortcut list

Weekly Installs

8.4K

Repository

vercel-labs/age…-browser

GitHub Stars

24.7K

First Seen

Feb 28, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex7.8K

opencode7.8K

gemini-cli7.8K

cursor7.7K

github-copilot7.7K

kimi-cli7.7K

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

102,200 周安装