cross-validated-search

OpenClaw 技能，用于源支持的网络搜索、页面阅读和证据感知声明检查。 使用它通过实时搜索结果和显式源处理来验证事实答案。

# Cross-Validated Search for OpenClaw

This skill gives OpenClaw a practical verification workflow:

- `search-web` for live search results
- `browse-page` for reading the full content of a source
- `verify-claim` for support/conflict classification
- `evidence-report` for a citation-ready summary with next steps

## Install

```bash
pip install cross-validated-search
```

## Minimum verification

```bash
search-web "OpenAI API pricing" --type news --timelimit w
verify-claim "Python 3.13 is the latest stable release" --deep --max-pages 2 --json
evidence-report "Python 3.13 stable release" --claim "Python 3.13 is the latest stable release" --deep --json
```

## Recommended flow

1. Run `search-web` for factual or recent questions.
2. Use `browse-page` on the most relevant source when snippets are not enough.
3. Use `verify-claim` when a concrete claim needs a support/conflict summary.
4. Use `evidence-report` when you want a compact evidence package with citations and next steps.
5. Use `--deep` when the claim matters enough to justify page-aware verification.
6. Cite the returned URLs in the final answer.

## What success looks like

- the verdict is explicit
- the result includes support and conflict scores
- `page_aware` is true when deep verification ran
- the recommended free path is `ddgs + self-hosted searxng`
- source URLs are ready to cite

## Limits

- `verify-claim` is heuristic and evidence-aware, not a proof engine.
- The default provider path is `ddgs`.
- The recommended free upgrade path is self-hosted `searxng` via `CROSS_VALIDATED_SEARCH_SEARXNG_URL`.
- Conflicting sources are surfaced, not automatically reconciled.

## License

MIT License.

---

## 中文说明

# 面向 OpenClaw 的交叉验证搜索（Cross-Validated Search）

此技能为 OpenClaw 提供了一套实用的验证工作流：

- `search-web` 获取实时搜索结果
- `browse-page` 阅读某个来源的完整内容
- `verify-claim` 进行支持/冲突分类
- `evidence-report` 生成可直接引用、附带后续步骤的摘要

## 安装

```bash
pip install cross-validated-search
```

## 最低限度的验证

```bash
search-web "OpenAI API pricing" --type news --timelimit w
verify-claim "Python 3.13 is the latest stable release" --deep --max-pages 2 --json
evidence-report "Python 3.13 stable release" --claim "Python 3.13 is the latest stable release" --deep --json
```

## 推荐流程

1. 对于事实性或时效性问题，运行 `search-web`。
2. 当摘要不足以说明问题时，对最相关的来源使用 `browse-page`。
3. 当某个具体声明需要支持/冲突的总结时，使用 `verify-claim`。
4. 当你需要一份带引用和后续步骤的紧凑证据包时，使用 `evidence-report`。
5. 当某个声明重要到值得进行页面级验证时，使用 `--deep`。
6. 在最终答案中引用返回的 URL。

## 成功的标志

- 结论是明确的
- 结果包含支持分数和冲突分数
- 当运行了深度验证时，`page_aware` 为 true
- 推荐的免费路径是 `ddgs + self-hosted searxng`
- 来源 URL 已准备好可供引用

## 限制

- `verify-claim` 是启发式且基于证据的，并非证明引擎。
- 默认的提供方路径是 `ddgs`。
- 推荐的免费升级路径是通过 `CROSS_VALIDATED_SEARCH_SEARXNG_URL` 使用自托管的 `searxng`。
- 冲突的来源会被呈现出来，但不会自动协调一致。

## 许可证

MIT 许可证。