← 返回 Skills 市场
120
总下载
0
收藏
0
当前安装
7
版本数
在 OpenClaw 中安装
/install q-research
功能描述
6-step structured research skill. Searches arXiv, reads 5 papers via markitdown, has Claude select the best 2, runs 4 targeted web searches (explanation, Git...
安全使用建议
This skill largely does what it says (download papers, convert, web-search, synthesize) but has a few red flags you should resolve before installing:
- Confirm which LLM provider it will use: the code calls Anthropic/Claude endpoints and has a --anthropic-key flag, but the registry only lists OPENROUTER_API_KEY. Ask the author which key the tool needs and whether OpenRouter or Anthropic will be used. Do not provide unrelated credentials.
- Review the code paths that send extracted PDF/text/web content to remote APIs (OpenRouter / Anthropic / Serper). If you plan to run on sensitive topics or internal URLs, be aware those contents will be transmitted externally.
- The included web_fetcher supports proxy pools, stealth headers, and curl_cffi fingerprinting — useful for scraping but able to bypass rate-limits/blocks. If that worries you, run the tool in a sandbox, restrict networking, or remove/disable proxy features.
- The SKILL.md tells you to pip-install packages and copy the script into /usr/local/bin. Prefer running inside a virtualenv or container instead of installing system-wide, and inspect the scripts' source before making them executable.
If you cannot get clarification from the publisher, treat this skill as untrusted: run it in an isolated environment, avoid supplying extra credentials until clarified, and consider adding the missing ANTHROPIC_API_KEY to the declared metadata only after confirming its legitimate need.
功能分析
Type: OpenClaw Skill
Name: q-research
Version: 1.3.0
The OWL research skill is a legitimate tool designed to automate academic and web-based research. It uses the arXiv API for paper discovery, the markitdown library for PDF-to-text conversion, and OpenRouter/Serper APIs for synthesis and web searching. Security analysis of 'owl.py' and 'web_fetcher.py' shows proper input sanitization (e.g., regex-based filename cleaning) to prevent shell injection, standard use of environment variables for API keys, and no evidence of data exfiltration or malicious persistence. The 'web_fetcher.py' script includes advanced scraping features like rate limiting and browser fingerprinting, which are consistent with its stated purpose of fetching web content for research.
能力标签
能力评估
Purpose & Capability
The skill claims to run a 6-step research pipeline (arXiv + web + LLM). Requiring SERPER_API_KEY (web search) makes sense. Requiring OPENROUTER_API_KEY could be reasonable if it uses OpenRouter as the LLM proxy, but the shipped code explicitly interacts with Anthropic/Claude endpoints (GET /v1/models, x-api-key headers, CLI flag --anthropic-key). The declared env list omits ANTHROPIC_API_KEY while the code expects an Anthropic key — this mismatch is incoherent and should be clarified. The web_fetcher module supports proxy pools and browser-fingerprinting libraries (curl_cffi, fake-useragent), which are stronger capabilities than a minimal research tool needs.
Instruction Scope
Runtime instructions (SKILL.md) match the stated pipeline (download PDFs, convert via markitdown, perform Serper searches, call an LLM to select and synthesize). However: (1) the SKILL.md and code reference Claude/Anthropic behavior but declared env vars don't include ANTHROPIC_API_KEY; (2) the tool fetches full web pages and sends them to remote LLM/search APIs — expected for this skill but important to note because fetched page contents (including private or paywalled snippets if URLs are provided) will be transmitted externally; (3) SKILL.md instructs installing packages and copying the script into /usr/local/bin, which writes to system locations rather than remaining instruction-only.
Install Mechanism
There is no formal registry install spec (instruction-only). SKILL.md contains explicit 'pip install ...' commands and 'cp scripts/owl.py /usr/local/bin' — these are manual steps that modify the system environment. The Python dependencies include markitdown, curl_cffi, BeautifulSoup, lxml and fake-useragent. Nothing is downloaded from obscure URLs, but the suggested installs create executable system-level tooling (potentially persistent) and install libraries used for stealthy scraping.
Credentials
Registry requires OPENROUTER_API_KEY and SERPER_API_KEY which is plausible (LLM proxy + web search). The code, CLI flags, and SKILL.md also reference ANTHROPIC_API_KEY / Claude and provide a --anthropic-key flag; yet ANTHROPIC_API_KEY is not declared as required. That mismatch is the primary disproportion — you may need to supply additional LLM credentials not listed. No other unrelated secrets are requested, but the omission reduces transparency.
Persistence & Privilege
The skill is not force-included (always: false) and allows normal autonomous invocation. It does not request to change other skills' configs. The SKILL.md does tell users to copy the script to /usr/local/bin (system-wide executable) which creates persistence on the host if followed, but this is a manual instruction rather than an automatic install step from the registry.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install q-research - 安装完成后,直接呼叫该 Skill 的名称或使用
/q-research触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.3.0
q-research 1.2.1
- Added scripts/web_fetcher.py to the project.
- Updated installation instructions to include new Python dependencies: curl_cffi, beautifulsoup4, lxml, and fake-useragent.
- Provided a Windows usage example for running owl from Python CLI.
- No changes to pipeline logic or output—documentation and dependency updates only.
v1.2.0
No user-facing changes detected in this version.
- No updates to SKILL.md content or functionality.
- Version incremented, but documentation and features are unchanged.
v1.0.4
- Added explicit Python invocation usage example: now documents running as python scripts/owl.py "query" for clarity.
- Minor documentation updates for consistency and clarity.
- No changes to functionality or CLI flags.
- No file or code changes detected in this version.
v1.0.3
script comment change
- Version bumped to 1.0.3 with no file changes detected.
v1.0.2
- Added metadata block specifying required environment variables (`OPENROUTER_API_KEY`, `SERPER_API_KEY`) and binaries (`python`).
- No other user-facing changes; all functionality, usage, and documentation remain unchanged.
v1.0.1
q-research 1.0.1
- Updated CLI flag in documentation: The environment variable for the Anthropic/Claude API key is now consistently referred to as OPENROUTER_API_KEY (was previously ANTHROPIC_API_KEY in step explanations and warning messages).
- Documentation in Step 4 and failure modes updated to match the new API key name.
- No changes to code or functionality; SKILL.md documentation update only.
v1.0.0
Initial release of the OWL structured research skill.
- Implements a 6-step pipeline combining arXiv paper selection, automated reading, LLM-driven filtering, and targeted web search.
- Automatically selects and deeply reads the top 2 of 5 arXiv papers using dynamic Claude model resolution.
- Runs 4 specific web searches (explanation, GitHub, survey, citations) and integrates findings with academic sources.
- Outputs a concise, citation-backed, 5-bullet research summary with clear sections for selected papers and sources.
- Includes a CLI with detailed flags for customization and a verification checklist at the end of each run.
元数据
常见问题
A research is searching around something. 是什么?
6-step structured research skill. Searches arXiv, reads 5 papers via markitdown, has Claude select the best 2, runs 4 targeted web searches (explanation, Git... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 120 次。
如何安装 A research is searching around something.?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install q-research」即可一键安装,无需额外配置。
A research is searching around something. 是免费的吗?
是的,A research is searching around something. 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
A research is searching around something. 支持哪些平台?
A research is searching around something. 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 A research is searching around something.?
由 Jay(@goog)开发并维护,当前版本 v1.3.0。
推荐 Skills