snapbyte-digest-api

使用 API 密钥身份验证从 Snapbyte 外部 API 获取个性化开发人员新闻摘要。用于 Hacker News 摘要、Reddit 摘要、Lobsters 摘要和 DEV.to 摘要工作流程。

# Snapbyte Digest API

Use this skill to fetch user-scoped digests from Snapbyte and present them as clean, high-signal markdown.

## When to use

- User asks for their latest digest.
- User asks for digest history.
- User asks for a digest's items or summary from Snapbyte API.
- User asks for a developer news digest API workflow in OpenClaw.

## Auth

- Requires `SNAPBYTE_API_KEY`.
- Send `Authorization: Bearer <SNAPBYTE_API_KEY>` to Snapbyte API.

## Base URL

- `https://api.snapbyte.dev`

## Command patterns

Run the helper script from this skill folder:

```bash
python3 scripts/snapbyte_digest.py configurations
python3 scripts/snapbyte_digest.py latest
python3 scripts/snapbyte_digest.py latest --configuration-id 12
python3 scripts/snapbyte_digest.py history --configuration-id 12 --page 1 --limit 10
python3 scripts/snapbyte_digest.py digest --id dst_abc123
python3 scripts/snapbyte_digest.py items --digest-id dst_abc123 --page 1 --limit 10
```

## Output rules

- Prefer formatted markdown output from script by default.
- If user asks for raw payload, pass `--raw`.
- Keep links intact and do not invent fields not returned by API.

## Failure handling

- `401`: tell user key is missing/invalid/revoked/expired and ask them to update `SNAPBYTE_API_KEY`.
- `404`: tell user digest/configuration was not found.
- Validation errors: show a short fix and rerun with corrected arguments.

## References

- See `references/quickstart.md` for setup and examples.

---

## 中文说明

# Snapbyte Digest API

使用此技能从 Snapbyte 获取以用户为范围的摘要，并以简洁、高信号的 markdown 形式呈现。

## 何时使用

- 用户请求获取其最新摘要。
- 用户请求获取摘要历史。
- 用户请求获取来自 Snapbyte API 的某个摘要的条目或概要。
- 用户在 OpenClaw 中请求开发者新闻摘要 API 工作流。

## 身份验证

- 需要 `SNAPBYTE_API_KEY`。
- 向 Snapbyte API 发送 `Authorization: Bearer <SNAPBYTE_API_KEY>`。

## 基础 URL

- `https://api.snapbyte.dev`

## 命令模式

从此技能文件夹运行辅助脚本：

```bash
python3 scripts/snapbyte_digest.py configurations
python3 scripts/snapbyte_digest.py latest
python3 scripts/snapbyte_digest.py latest --configuration-id 12
python3 scripts/snapbyte_digest.py history --configuration-id 12 --page 1 --limit 10
python3 scripts/snapbyte_digest.py digest --id dst_abc123
python3 scripts/snapbyte_digest.py items --digest-id dst_abc123 --page 1 --limit 10
```

## 输出规则

- 默认优先使用脚本输出的格式化 markdown。
- 如果用户请求原始负载，传入 `--raw`。
- 保持链接完整，不要臆造 API 未返回的字段。

## 失败处理

- `401`：告知用户密钥缺失/无效/被吊销/已过期，并请其更新 `SNAPBYTE_API_KEY`。
- `404`：告知用户未找到摘要/配置。
- 校验错误：给出简短的修复方法，并用修正后的参数重新运行。

## 参考

- 设置与示例请参见 `references/quickstart.md`。