← 返回 Skills 市场
coze-web-search
作者
hanxueyuan
· GitHub ↗
· v0.1.0
· MIT-0
432
总下载
1
收藏
7
当前安装
2
版本数
在 OpenClaw 中安装
/install coze-web-search
功能描述
Search the web using coze-coding-dev-sdk. Supports web search, image search, AI summaries, time filters, and site restrictions.
使用说明 (SKILL.md)
Coze Web Search
Search the web using coze-coding-dev-sdk. Returns structured results with URLs, snippets, and AI summaries.
Quick Start
Basic Search
npx ts-node {baseDir}/scripts/search.ts -q "Python programming"
With Time Filter
npx ts-node {baseDir}/scripts/search.ts \
-q "AI news" \
--time-range 1w \
--count 15
Site-Specific Search
npx ts-node {baseDir}/scripts/search.ts \
-q "Python tutorials" \
--sites "python.org,github.com,stackoverflow.com"
Image Search
npx ts-node {baseDir}/scripts/search.ts \
-q "mountain landscape" \
--type image \
--count 20
Output as Markdown
npx ts-node {baseDir}/scripts/search.ts \
-q "machine learning" \
--format markdown
Script Options
| Option | Description |
|---|---|
-q, --query \x3Ctext> |
Search query (required) |
--type \x3Ctype> |
web or image (default: web) |
--count \x3Cn> |
Number of results (default: 10) |
--time-range \x3Crange> |
1d, 1w, 1m (web only) |
--sites \x3Cdomains> |
Comma-separated domains to include |
--block-hosts \x3Cdomains> |
Comma-separated domains to exclude |
--no-summary |
Disable AI summary |
--need-content |
Include full page content |
--format \x3Cfmt> |
json, text, markdown (default: text) |
Time Range
| Value | Description |
|---|---|
1d |
Last 24 hours |
1w |
Last week |
1m |
Last month |
Output Formats
Text (default)
============================================================
AI SUMMARY
============================================================
Python is a high-level programming language...
============================================================
SEARCH RESULTS (10 items)
============================================================
[1] Python.org
URL: https://www.python.org
Source: Python Software Foundation
The official home of the Python Programming Language...
Markdown
Formatted with headers, links, and collapsible content sections.
JSON
Raw API response.
Notes
- Use
--time-rangefor recent content - Use
--sitesto limit to trusted sources - Use
--need-contentsparingly (increases response size)
安全使用建议
This skill mostly does what it says (uses the coze SDK to search and summarize), but it doesn't declare the likely required API credential. Before installing or running it: 1) inspect the coze-coding-dev-sdk docs or the SDK's Config class to confirm how it expects API keys (env var name, config file, etc.); 2) avoid supplying high-privilege or unrelated credentials until you verify the exact key the SDK needs; 3) be aware that 'npx ts-node' will fetch packages from npm at runtime — run in an isolated environment if you are concerned about supply-chain risk; 4) if you will provide an API key, create a limited-scope key with minimal privileges and rotate it if possible; and 5) ask the skill author to update SKILL.md to explicitly list required env vars and any network endpoints the SDK contacts. If you cannot verify the SDK's credential behavior, treat the skill as potentially risky and test it in a sandbox first.
功能分析
Type: OpenClaw Skill
Name: coze-web-search
Version: 0.1.0
The skill provides a legitimate interface for web and image searching via the coze-coding-dev-sdk. The implementation in scripts/search.ts is a straightforward CLI wrapper that handles argument parsing and result formatting (Text, Markdown, JSON) without any evidence of malicious intent, data exfiltration, or unauthorized execution.
能力评估
Purpose & Capability
Name/description match the code: the script uses the coze-coding-dev-sdk to perform web and image searches and produce summaries. Requiring 'npx' is reasonable because the usage examples invoke 'npx ts-node'. However, the skill declares no required environment variables or primary credential even though the SDK/Config class in the code likely needs an API key or account config to call the coze service — this is an unexplained omission.
Instruction Scope
SKILL.md instructs the agent to run the included TypeScript script via npx/ts-node with explicit CLI flags. The instructions stay within the stated purpose (search, time filters, site restrictions, optional full page content). They do not instruct reading arbitrary local files or other system-sensitive data.
Install Mechanism
There is no explicit install spec; the skill is instruction-only but bundles scripts/search.ts. The runtime relies on npx to fetch ts-node and any transitive npm dependencies at execution time — this is a normal approach but introduces typical supply-chain risk (remote package fetch/execution). No arbitrary download URLs or extract steps are present in the skill itself.
Credentials
The skill declares no required env vars or credentials, but the code constructs 'new Config()' and instantiates a SearchClient from 'coze-coding-dev-sdk' without supplying credentials. In practice the SDK likely reads an API key or similar from env or config files (not declared in SKILL.md), so the skill's declared requirements are incomplete and under-specified. That mismatch could cause surprise when a user is asked to provide keys or when the SDK reads credentials from unexpected locations.
Persistence & Privilege
The skill is not always-enabled and does not request system-wide persistence. It doesn't modify other skills or global agent configuration in the provided files and runs as an invoked command, which is proportionate for this functionality.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install coze-web-search - 安装完成后，直接呼叫该 Skill 的名称或使用
/coze-web-search触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.1.0
Initial release.
- Search the web using coze-coding-dev-sdk.
- Supports web and image search, AI summaries, time filters, and site restrictions.
- Multiple output formats: text, markdown, and JSON.
- Command-line tool with various options for search customization.
v1.0.0
Initial release of coze-web-search.
- Search the web or images using coze-coding-dev-sdk with flexible options.
- Supports filters: time range, result count, site inclusion/exclusion, and content format (json, text, markdown).
- Optionally generates AI-powered summaries and can include full page content.
- Command line interface with clear usage examples and option descriptions.
元数据
常见问题
coze-web-search 是什么？
Search the web using coze-coding-dev-sdk. Supports web search, image search, AI summaries, time filters, and site restrictions. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 432 次。
如何安装 coze-web-search？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install coze-web-search」即可一键安装，无需额外配置。
coze-web-search 是免费的吗？
是的，coze-web-search 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
coze-web-search 支持哪些平台？
coze-web-search 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 coze-web-search？
由 hanxueyuan（@hanxueyuan）开发并维护，当前版本 v0.1.0。
推荐 Skills