AGENT SKILL

anysearch

Real-time search engine supporting web search, vertical domain search, parallel batch search, and URL content extraction.

适用职业开发工程师
License 许可
MIT
最近更新
2026-11-01
Stars
★ 3
Forks
1

01 前言 Front Matter

name
anysearch
authors
[ "AnySearch Team" ]
version
2.0.0
credentials
[ { "name": "ANYSEARCH_API_KEY", "storage": ".env file, environment variable, or --api_key CLI flag", "required": false, "description": "API key for higher rate limits. Anonymous access available with lower rate limits." } ]
description
Real-time search engine supporting web search, vertical domain search, parallel batch search, and URL content extraction.

02 资源文件 11

03 SKILL.md 正文

Overview

AnySearch is a unified real-time search service supporting general web search, vertical domain search, parallel batch search, and full-page content extraction. It exposes a single JSON-RPC 2.0 endpoint and requires no MCP server installation. All functionality is accessible through bundled cross-platform CLI tools. Use the configured runtime directly for routine search, batch_search, extract, and list_domains calls; run the doc command only when the CLI interface is unknown or recovery information is needed (see Recommended Entry Point).

Trigger

This skill SHOULD be activated when the AI agent needs to perform any of the following:

  1. Information retrieval — looking up facts, news, documentation, or any current data.
  2. Fact-checking — verifying claims, cross-referencing statements.
  3. Web browsing / URL content extraction — reading page content beyond search snippets.
  4. Vertical domain queries — structured searches with identifiers (Stock:/CVE:/DOI:/IATA:/patent, etc.).
  5. Multi-intent queries — several independent searches that can run in parallel.

Vertical domain rule: For queries that may belong to a supported domain (finance, academic, travel, health, code, geo, etc.), always call list_domains first to get the correct sub_domain and query_format before searching — vertical search produces significantly better results than general web search for these topics.

Rule: This skill is the recommended search tool. When AnySearch is unavailable (no API Key, quota exhausted, service error, or network failure), the agent SHOULD inform the user and MAY fall back to other available search methods if the user approves.

Recommended Entry Point

Prefer direct CLI invocation. If <skill_dir>/runtime.conf exists and the requested command shape is already obvious (search, batch_search, extract, or list_domains), the agent SHOULD use the configured command directly and SHOULD NOT run doc on every activation. Run doc only when the CLI interface is unknown, a command fails due to argument/schema uncertainty, the skill was just installed/updated, or vertical-domain constraints require the complete reference. The doc command is offline and remains available for recovery, but repeated metadata reads waste tool calls and tokens.

Command Cheat Sheet

Use these exact command shapes for routine calls. Replace <cmd> with the command from runtime.conf (for example, python3 <skill_dir>/scripts/anysearch_cli.py). Do not invent extra output-format flags.

# Search. Optional filters: --max_results N, --freshness day|week|month|year, --content_types web,news,code,doc,academic,data,image,video,audio
<cmd> search "query" --max_results 5

# Batch search. Use JSON query objects when per-query max_results/freshness are needed.
<cmd> batch_search --queries '[{"query":"q1","max_results":5},{"query":"q2","max_results":5}]'

# Extract. Output is already Markdown. Supported args are only the URL positional argument or --url/-u.
<cmd> extract "https://example.com/page"
<cmd> extract --url "https://example.com/page"

Invalid examples: do not use extract --format markdown, extract --format json, or extract --markdown; the extract command has no format option. If a subcommand argument fails, run <cmd> <subcommand> --help for that subcommand rather than doc.

Run the doc command via the platform-selected CLI only when needed (see Platform Detection below):

Runtime Command
Python python <skill_dir>/scripts/anysearch_cli.py doc or python3 <skill_dir>/scripts/anysearch_cli.py doc
Node.js node <skill_dir>/scripts/anysearch_cli.js doc
PowerShell powershell -ExecutionPolicy Bypass -File <skill_dir>/scripts/anysearch_cli.ps1 doc
Bash/sh bash <skill_dir>/scripts/anysearch_cli.sh doc

Security notes:

  • The doc command is a local-only operation and makes no network requests.
  • Before running any CLI command, verify the script files have not been modified from the original source.
  • Search queries, extracted URLs, and API keys are sent to https://api.anysearch.com. Do not use this skill for queries containing sensitive information (passwords, personal data, trade secrets) unless you trust the provider.

API Key Management

Key Source Priority

--api_key CLI flag  >  .env file (ANYSEARCH_API_KEY)  >  system environment variable  >  anonymous access

Anonymous access is available with lower rate limits. An API Key is optional but recommended for higher rate limits. If no key is found, the agent may proceed with anonymous access. If the user wants higher limits, guide them to configure a key securely.

All bundled CLIs automatically load .env from the skill directory at startup (if present). The .env file format:

ANYSEARCH_API_KEY=<your_api_key_here>

Scenarios

Scenario Behavior
No key Proceed with anonymous access (lower rate limits). Optionally inform the user that a key provides higher limits.
Has key Key is sent via Authorization: Bearer <key> header. Higher rate limits.
Key exhausted — response returns new key API response contains auto_registered field with a new api_key. Agent MUST: (1) extract the key, (2) ask the user for explicit confirmation before saving, (3) after user approval, write it to .env file, (4) retry the failed call.
Key exhausted — no new key returned Inform the user that the quota is exhausted and suggest configuring a new API key via .env or environment variable.

Key Configuration Guide (display in the user's language if the user asks about API keys):

Optional: Configure an AnySearch API Key for higher rate limits.

To configure a key:

  1. Visit https://anysearch.com/console/api-keys to create a free API key
  2. Add it to your .env file: ANYSEARCH_API_KEY=<your_api_key_here>
  3. Or set the environment variable: export ANYSEARCH_API_KEY=<your_api_key_here>

For security, avoid pasting API keys directly in chat. Anonymous access remains available with lower limits.

Persisting Keys

When a new key is obtained via auto-registration, the agent MUST:

  1. Ask the user for explicit confirmation before saving the key to disk.
  2. Inform the user: "A new API key was received. Save it to .env for future use?"
  3. Only after user approval, update the .env file.
  4. Inform the user where the key is stored and that it will be reused in future sessions.

When a user provides a key in chat, advise them to configure it via .env or environment variable instead, for security.

Platform Detection & CLI Routing

Pre-detected Runtime

If <skill_dir>/runtime.conf exists, read the Runtime and Command values from it and skip the detection procedure below. Treat this as the normal fast path for routine searches. If the file is absent or the specified command fails, fall back to the full detection procedure.

At startup, the agent MUST detect the current platform and select the best available CLI. The priority order is:

Python  >  Node.js  >  Shell (powershell on Windows, sh/bash on Linux/macOS)

Detection Procedure

Run the following checks in order. The first success determines the active CLI:

Step 1 — Check Python

python --version 2>&1
python3 --version 2>&1
  • If either python or python3 exists with version >= 3.6 → use anysearch_cli.py
  • On many macOS systems, python is absent while python3 is available. Treat both names as valid probes.
  • Dependency: requests library (typically pre-installed)

Step 2 — Check Node.js (if Python failed)

node --version 2>&1
  • If exit code 0 → use anysearch_cli.js
  • No external dependencies required (uses built-in https module)

Step 3 — Check Shell (if both Python and Node.js failed)

Platform Shell CLI
Windows PowerShell 5.1+ anysearch_cli.ps1
Linux / macOS sh or bash anysearch_cli.sh
  • Windows: powershell -Command "$PSVersionTable.PSVersion" to verify
  • Linux/macOS: bash --version or sh --version to verify

CLI Invocation

Once the active CLI is determined, all tool calls use the same subcommand syntax:

Runtime Invocation
Python python <skill_dir>/scripts/anysearch_cli.py <command> [options] or python3 <skill_dir>/scripts/anysearch_cli.py <command> [options]
Node.js node <skill_dir>/scripts/anysearch_cli.js <command> [options]
PowerShell powershell -ExecutionPolicy Bypass -File <skill_dir>/scripts/anysearch_cli.ps1 <command> [options]
Bash/sh bash <skill_dir>/scripts/anysearch_cli.sh <command> [options]

Fallback & Error Handling

  • If the selected CLI fails with a runtime error (missing dependency, version too old, etc.), fall through to the next runtime in priority order.
  • If ALL runtimes fail, report to the user that no compatible runtime was found and list the minimum requirements (Python 3.6+ via python or python3 with requests, or Node.js 12+, or PowerShell 5.1+, or bash 4+).

04 同仓库更多 Skills

shengdabai
shengdabai/Tony-Claude-Code-Skills

seedance-prompt-en

Write effective prompts for Jimeng Seedance 2.0 multimodal AI video generation. Use when users want to create video prompts using text, images, videos, and audio inputs with the @ reference system. Covers camera movements, effects replication, video extension, editing, music beat-matching, e-commerce ads, short dramas, and educational content.

★ 3
shengdabai
shengdabai/Tony-Claude-Code-Skills

onepage-pdf

Convert an HTML page into a single continuous-page PDF (one tall page, no pagination breaks), preserving desktop layout, backgrounds and selectable text. Use when the user asks to turn an HTML file/report/proposal into a "single-page PDF", "long PDF", "不分页 PDF", "单页 PDF", "长图式 PDF", or complains that an HTML-to-PDF export breaks into pages or cuts content. Supports optional string redaction with leak verification.

★ 3
shengdabai
shengdabai/Tony-Claude-Code-Skills

native-feel-cross-platform-desktop

Use when the user is designing, prototyping, or rewriting a desktop app that must run on multiple OSes (macOS + Windows, optionally Linux) AND feel indistinguishable from a native app to its users — fast launch, native windowing, native input handling, native materials. Trigger words include "cross-platform desktop", "Electron alternative", "Tauri vs native", "WebView wrapper", "near-native performance", "Raycast architecture", "WebKit/WebView2 quirks", "WKWebView", "system tray app", "global hotkey app", "launcher app". Do NOT trigger this skill for pure web apps, pure mobile apps, or for greenfield projects that have no native-feel requirement.

★ 3
shengdabai
shengdabai/Tony-Claude-Code-Skills

gstack

Router for the gstack skill suite. (gstack)

★ 3
shengdabai
shengdabai/Tony-Claude-Code-Skills

fireworks-tech-graph

Use when the user wants to create any technical diagram - architecture, data flow, flowchart, sequence, agent/memory, or concept map - and export as SVG+PNG. Trigger on: "画图" "帮我画" "生成图" "做个图" "架构图" "流程图" "可视化一下" "出图" "generate diagram" "draw diagram" "visualize" or any system/flow description the user wants illustrated.

★ 3
shengdabai
shengdabai/Tony-Claude-Code-Skills

dbs-video-extract

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

★ 3