← Back to Skills Marketplace
coze-web-search
by
hanxueyuan
· GitHub ↗
· v0.1.0
· MIT-0
432
Downloads
1
Stars
7
Active Installs
2
Versions
Install in OpenClaw
/install coze-web-search
Description
Search the web using coze-coding-dev-sdk. Supports web search, image search, AI summaries, time filters, and site restrictions.
README (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)
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install coze-web-search - After installation, invoke the skill by name or use
/coze-web-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is coze-web-search?
Search the web using coze-coding-dev-sdk. Supports web search, image search, AI summaries, time filters, and site restrictions. It is an AI Agent Skill for Claude Code / OpenClaw, with 432 downloads so far.
How do I install coze-web-search?
Run "/install coze-web-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is coze-web-search free?
Yes, coze-web-search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does coze-web-search support?
coze-web-search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created coze-web-search?
It is built and maintained by hanxueyuan (@hanxueyuan); the current version is v0.1.0.
More Skills