parallel-monitor

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Web Monitor

网页监控

Action: $ARGUMENTS

Requires
parallel-cli
≥ 0.3.0 (the
monitor
command was added in 0.3.0). If
parallel-cli monitor
errors with
no such command
or similar, tell the user to run
parallel-cli update
(or
pipx upgrade parallel-web-tools
if installed via pipx), then retry.

Action: $ARGUMENTS

需要
parallel-cli
≥ 0.3.0（
monitor
命令在0.3.0版本中新增）。如果执行
parallel-cli monitor
时出现“no such command”或类似错误，请告知用户运行
parallel-cli update
（如果通过pipx安装，则运行
pipx upgrade parallel-web-tools
），然后重试。

What this skill does

该技能的作用

Monitors are long-running, server-side jobs that re-check the web on a cadence and emit events when something changes. Unlike search/research/findall (one-shot lookups), monitors persist until deleted and can optionally fire a webhook on each event.

监控任务是长期运行的服务器端作业，会按周期重新检查网页，并在内容发生变化时触发事件。与搜索/调研/findall（一次性查询）不同，监控任务会持续存在直到被删除，并且可以选择在每次事件触发时调用webhook。

Decide the action

确定操作

Parse the user's request and pick one:

Intent	Action
"Track / watch / monitor / alert me when X"	create
"What am I monitoring?" / "List monitors"	list
"What changed?" / "Show me events for monitor X"	events
"Show monitor X" / "Get details for X"	get
"Change cadence / query / webhook for X"	update
"Test the webhook" / "Fire a test event"	simulate (requires a webhook on the monitor)
"Show me the full payload for event group X"	event-group
"Stop / delete monitor X"	delete (always confirm before deleting)

解析用户请求并选择对应操作：

意图	操作
"跟踪/关注/监控/当X发生时提醒我"	create（创建）
"我正在监控什么？"/"列出监控任务"	list（列出）
"有什么变化？"/"显示监控任务X的事件"	events（查看事件）
"显示监控任务X"/"获取X的详情"	get（获取详情）
"修改X的周期/查询条件/webhook"	update（更新）
"测试webhook"/"触发测试事件"	simulate（模拟触发）（要求监控任务已配置webhook）
"显示事件组X的完整负载"	event-group（查看事件组）
"停止/删除监控任务X"	delete（删除）（删除前务必确认）

Create a monitor

创建监控任务

bash

parallel-cli monitor create "<query>" --cadence daily --json

Cadence options:

hourly

daily

(default),

weekly

every_two_weeks

. Match cadence to how often the source actually changes — hourly for prices/news, weekly for filings/staffing.

Optional flags:

```
--webhook https://example.com/hook
```
— POST events to a URL as they happen
```
--metadata '{"team":"competitive-intel"}'
```
— attach JSON metadata for your own bookkeeping
```
--output-schema '<json>'
```
— structure the event payload (advanced)

Parse the JSON to extract the

monitor_id

. Tell the user:

The monitor has been created with its ID
The cadence (so they know when to expect first event)
That events accumulate server-side — they can run
```
parallel-cli monitor events $MONITOR_ID
```
later to see what changed

If they configured a webhook, suggest testing it:

bash

parallel-cli monitor simulate "$MONITOR_ID"

simulate

requires a webhook to be configured on the monitor. Without one it errors with

Webhook not configured for this monitor

— do not run it on monitors created without

--webhook

bash

parallel-cli monitor create "<query>" --cadence daily --json

周期选项：

hourly

（每小时）、

daily

（每天，默认）、

weekly

（每周）、

every_two_weeks

（每两周）。根据数据源的实际更新频率选择周期——价格/新闻选每小时，文件/人员配置选每周。

可选参数：

```
--webhook https://example.com/hook
```
—— 事件发生时向指定URL发送POST请求
```
--metadata '{"team":"competitive-intel"}'
```
—— 添加JSON元数据用于自身记录
```
--output-schema '<json>'
```
—— 结构化事件负载（高级功能）

解析JSON以提取

monitor_id

。告知用户：

监控任务已创建并提供其ID
周期（让用户知道何时会收到第一个事件）
事件会在服务器端累积——之后可以运行
```
parallel-cli monitor events $MONITOR_ID
```
查看变化内容

如果用户配置了webhook，建议测试：

bash

parallel-cli monitor simulate "$MONITOR_ID"

simulate

要求监控任务已配置webhook。未配置时会报错

Webhook not configured for this monitor

——不要在未使用

--webhook

创建的监控任务上执行该命令。

List monitors

列出监控任务

bash

parallel-cli monitor list -n 10 --json

Default to

-n 10

— accounts with many historical monitors can return megabytes of JSON otherwise. Raise the limit only if the user explicitly asks for "all" or a larger set. Present as a table: ID, query (truncated), cadence, created.

Note:
monitor list
is not guaranteed to be sorted newest-first, so a monitor you just created may not appear in the first page of results. If a user is verifying creation, prefer
monitor get $MONITOR_ID
(using the ID returned by create) over scanning the list.

bash

parallel-cli monitor list -n 10 --json

默认使用

-n 10

——否则拥有大量历史监控任务的账户可能返回数MB的JSON。仅当用户明确要求“全部”或更大范围时才提高限制。以表格形式展示：ID、查询内容（截断显示）、周期、创建时间。

注意：
monitor list
不保证按创建时间倒序排列，因此刚创建的监控任务可能不会出现在第一页结果中。如果用户要验证创建结果，优先使用
monitor get $MONITOR_ID
（使用创建时返回的ID）而非遍历列表。

View events for a monitor

查看监控任务的事件

bash

parallel-cli monitor events "$MONITOR_ID" --lookback 10d --json

Lookback format:

Nd

(days) or

Nw

(weeks). Default

10d

For deeper detail on a specific event group:

bash

parallel-cli monitor event-group "$MONITOR_ID" "$EVENT_GROUP_ID" --json

Summarize for the user: count of events in the period, then a bulleted list of what changed with timestamps. Cite source URLs from the event payload.

bash

parallel-cli monitor events "$MONITOR_ID" --lookback 10d --json

回溯格式：

Nd

（天）或

Nw

（周）。默认

10d

。

如需查看特定事件组的详细信息：

bash

parallel-cli monitor event-group "$MONITOR_ID" "$EVENT_GROUP_ID" --json

为用户总结：该时间段内的事件数量，然后以项目符号列表形式展示变化内容及时间戳。引用事件负载中的源URL。

Get / update / delete

获取/更新/删除监控任务

bash

parallel-cli monitor get "$MONITOR_ID" --json
parallel-cli monitor update "$MONITOR_ID" --cadence weekly --json
parallel-cli monitor delete "$MONITOR_ID" --json

Always confirm before deleting — deletion is permanent.

bash

parallel-cli monitor get "$MONITOR_ID" --json
parallel-cli monitor update "$MONITOR_ID" --cadence weekly --json
parallel-cli monitor delete "$MONITOR_ID" --json

删除前务必确认——删除操作不可恢复。

Setup

安装配置

parallel-cli

is not found, install and authenticate:

bash

curl -fsSL https://parallel.ai/install.sh | bash

If unable to install that way, install via pipx instead:

bash

pipx install "parallel-web-tools[cli]"
pipx ensurepath

Then authenticate:

bash

parallel-cli login

Or set an API key:

export PARALLEL_API_KEY="your-key"

如果未找到

parallel-cli

，请安装并验证身份：

bash

curl -fsSL https://parallel.ai/install.sh | bash

如果无法通过上述方式安装，可通过pipx安装：

bash

pipx install "parallel-web-tools[cli]"
pipx ensurepath

然后验证身份：

bash

parallel-cli login

或设置API密钥：

export PARALLEL_API_KEY="your-key"