Mysearch

What it does

When your agent uses it

• ANY external lookup that needs current web results
• Tasks that involve Web search
• Tasks that involve Web scraping

Example prompts

• “/mysearch”

Requirements

• Python 3
• A Bash shell
• A credential in MYSEARCH_PROXY_API_KEY
• A credential in MYSEARCH_TAVILY_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 52df2a0. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 2 files in scripts/ (Python and Shell), which the agent can run.

  Shell commands in SKILL.md call:

  • python3
  • bash

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • search.hunters.works

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • MYSEARCH_PROXY_API_KEY
  • MYSEARCH_TAVILY_API_KEY
  • MYSEARCH_FIRECRAWL_API_KEY
  • MYSEARCH_XAI_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mysearch loads about 1.4k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 235 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~86

When it runs · the whole SKILL.md, loaded when a task matches

~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:18

  copying a .env file into an installed skill folder. Only point

• NoteMentions a .env fileSKILL.md:113

  `skills.entries.mysearch.env`，正式部署不需要依赖 `.env`。

• NoteMentions a .env fileSKILL.md:149

  在你直接调试这个仓库工作树时，才建议复制 `.env.example` 到本地 `.env`。

• NoteMentions a .env fileSKILL.md:156

  cp {baseDir}/.env.example {baseDir}/.env

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from skernelx/MySearch-Proxy at commit 52df2a0, republished under its MIT licence (© skernelx). 235 words, ~1,423 tokens.

name

mysearch

description

DEFAULT search skill for OpenClaw. Aggregates Tavily, Firecrawl, Exa, and optional X/social search behind one search path. Use for ANY external lookup that needs current web results, docs, GitHub, changelog, pricing, URL extraction, or X discussion. Prefer this over legacy Tavily-only skill or raw web_search when MySearch is healthy.

version

0.1.13

author

skernelx

license

MIT

repository

https://github.com/skernelx/MySearch-Proxy

homepage

https://github.com/skernelx/MySearch-Proxy/tree/main/openclaw

security_disclosure

MySearch sends queries and whichever provider or proxy credentials you configure to the configured endpoints for Tavily, Firecrawl, Exa, and optional…

{
  "skills": {
    "entries": {
      "mysearch": {
        "enabled": true,
        "env": {
          "MYSEARCH_PROXY_BASE_URL": "https://search.hunters.works",
          "MYSEARCH_PROXY_API_KEY": "mysp-..."
        }
      }
    }
  }
}

{
  "skills": {
    "entries": {
      "mysearch": {
        "enabled": true,
        "env": {
          "MYSEARCH_TAVILY_API_KEY": "tvly-...",
          "MYSEARCH_FIRECRAWL_API_KEY": "fc-..."
        }
      }
    }
  }
}

cp {baseDir}/.env.example {baseDir}/.env
python3 {baseDir}/scripts/mysearch_openclaw.py health

bash {baseDir}/scripts/install_openclaw_skill.sh --install-to ~/.openclaw/skills/mysearch

python3 {baseDir}/scripts/mysearch_openclaw.py health

python3 {baseDir}/scripts/mysearch_openclaw.py search \
  --query "best search MCP server" \
  --mode web

python3 {baseDir}/scripts/mysearch_openclaw.py search \
  --query "today's biggest stories on X" \
  --mode social \
  --intent status

python3 {baseDir}/scripts/mysearch_openclaw.py search \
  --query "today's biggest stories on X" \
  --sources web,x \
  --intent status \
  --strategy verify

python3 {baseDir}/scripts/mysearch_openclaw.py search --query "..." --mode social --intent status
python3 {baseDir}/scripts/mysearch_openclaw.py search --query "..." --mode news --intent status

python3 {baseDir}/scripts/mysearch_openclaw.py search \
  --query "OpenAI responses API pricing" \
  --mode docs \
  --intent resource

python3 {baseDir}/scripts/mysearch_openclaw.py extract \
  --url "https://example.com/post"

python3 {baseDir}/scripts/mysearch_openclaw.py research \
  --query "best search MCP server 2026" \
  --intent exploratory \
  --include-social

© skernelx, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (scripts) in openclaw of skernelx/MySearch-Proxy.

• SKILL.md
• .env.example
• README.md
• README_EN.md
• agents/openai.yaml
• public.json
• runtime/mysearch/__init__.py
• runtime/mysearch/clients.py
• runtime/mysearch/config.py
• runtime/mysearch/keyring.py
• scripts/install_openclaw_skill.sh
• scripts/mysearch_openclaw.py

Open the folder on GitHubat commit 52df2a0