Use the public REST endpoints across Python, Node.js, PowerShell, and Bash; keep batch search client-side, preserve legacy CLI aliases, add cross-runtime contract coverage, update the Extract documentation, and remove the unused runtime configuration template.
Removes two sections confirmed by maintainers as unintended external promotion:
- Social Media Source Workflow sections (PR #19): redundant restatement of the
generic vertical-search flow used to advertise the author's own npm package
- Download History chart (PR #10): third-party skill-history.com badge
batch_search previously supported three shared params (--domain/-d,
--sub_domain/-s, --sub_domain_params/--sdp/-p) but not --max_results/-m,
even though every query item and the search subcommand already support
it. Adds --max_results/-m as a fourth shared param with identical
semantics: injected into each query item that doesn't set its own
max_results, item's own value always takes precedence. The shared value
injected is capped at min(x, 10), matching the search subcommand's
client-side cap; a per-item max_results is left uncapped as before.
Implemented identically in scripts/anysearch_cli.py, .js, .ps1, and .sh.
Updated scripts/shared/doc_spec.md and SKILL.md to document the new
shared param, and added a TEST_PLAN.md case.
- document single-call email registration flow (no verification code) with
success/error code handling in README
- send X-Anysearch-Client: skill/2.1.0 header from js/ps1/py/sh CLI scripts,
version aligned with SKILL.md
The Python CLI requires 'requests' (from requirements.txt) which is not
pre-installed in the CI environment. Without it, 'import requests' fails
and the doc output check reports a false positive non-zero exit.
- Add social_media usage examples to README.md, SKILL.md, and doc_spec.md
- Clarify AnySearch as public discovery layer vs. authenticated tool handoff
- Document TweetClaw as example follow-up tool for account-scoped X/Twitter operations
- Add _need_val guard to prevent infinite loop when value-taking flag has no argument
- Check HTTP status code from curl; treat >= 400 as error on stderr with exit 1
- Aligns Bash CLI error behavior with Python/Node CLIs
- Fix extra closing brace in generate.py pattern that prevented placeholder substitution in bash CLI
- Regenerate scripts/anysearch_cli.sh with correct doc output
- Add .github/workflows/ci.yml: runs generate.py --check and asserts no unreplaced placeholders
- Fix # in API key values being silently truncated (treated as inline comment)
- Only treat # as comment at start of line, matching Python CLI behavior
- Unify .env loader behavior across all four CLIs
- Remove query_format and zone from doc_spec.md return columns (no longer in MCP)
- Rewrite Decision Flow to match MCP Path 1/Path 2/Hybrid model
- Rewrite Vertical Search Semantic Constraints: remove query_format section
- SKILL.md: replace query_format with required params, align decision flow
- Rename list_domains references to get_sub_domains across all files
- Remove --content_types, --zone, --freshness from search tool docs
- Add CLI-only annotation to batch_search --query shorthand
- Regenerate all 4 CLI scripts via generate.py
Agents can interpret the recommended entry point as requiring a doc call whenever the skill is loaded. That burns a tool call before ordinary search/extract operations and still leaves room for argument hallucinations such as extract --format markdown.
This updates the guidance to treat runtime.conf as the fast path for routine calls, keeps doc as a recovery/reference command, and documents the exact extract argument shape.
Constraint: No CLI behavior or API contract changes; documentation-only patch
Rejected: Change the CLI to accept --format markdown | hides agent misuse instead of documenting the real interface
Confidence: high
Scope-risk: narrow
Tested: git diff --check; python3 scripts/anysearch_cli.py extract --help
Not-tested: Live behavior inside upstream-installed OpenCode or Claude Code sessions
The README currently points OpenCode users at ~/.opencode/skills, but current OpenCode user configuration stores skills under ~/.config/opencode/skills. The wrong path makes a copied skill undiscoverable and can push users or agents toward other agent-specific copies.
Constraint: Documentation-only path correction
Confidence: high
Scope-risk: narrow
Tested: git diff --check
Not-tested: Fresh OpenCode install discovery from the corrected directory
Allow `.env` values to override existing environment variables, matching the documented priority order. Also read `.env` with `utf-8-sig` and strip a possible BOM from key names for better Windows compatibility.
允许 `.env` 中的值覆盖已有环境变量，以符合文档中声明的优先级顺序。同时使用 `utf-8-sig` 读取 `.env`，并清理 key name 中可能存在的 BOM，以提升 Windows 兼容性。
AnySearch