Document that anyapi search accepts a scope with no query - #17
Merged
Conversation
Three fixes, each verified against the live gateway or the published package. `getanyapi.com/docs/langchain` 404s, so our open PR against LangChain's own integrations tables (langchain-ai/docs#5886) had to point `docs_url` at a GitHub README instead of at us. `langchain.mdx` serves that exact URL. Every tool name, argument and default on it came from installing `langchain-anyapi` 0.1.0 from PyPI and printing each tool's `.name` and `.args_schema.model_json_schema()`, not from the README. The MCP page described only the hosted endpoint. `getanyapi-com/mcp` now publishes a local stdio server that forwards to it, for clients that cannot speak remote Streamable HTTP. The npx, Claude Code and Docker recipes are the ones the MCP Registry entry `io.github.getanyapi-com/anyapi` declares at 0.1.2. The page also told customers that `list_apis`, `search_apis` and `get_api` work "without a key". They do not, and have not. Measured against production: an anonymous `initialize` and `tools/list` both return 200, and `tools/call` on each of those three returns HTTP 401 `unauthorized`. What is keyless is the handshake and the tool listing. The note now says that, and points at `GET /catalog` and `GET /catalog/search`, which really are keyless (both 200 with no credential). This documents current behavior and asks for no change to it. Quickstart now says `q` is optional on `/catalog/search`. Measured today: `?platform=reddit` and `?category=social` each return 200, and a bare `/catalog/search` returns 400 `"name q, category, or platform"`. The generated API reference already had this right. Gate: check-docs-nav.sh, check-agent-contract.sh, mint validate, and mint broken-links all pass. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The CLI reference still showed
anyapi search <query>as the only form.anyapi-cli@0.9.0, published today fromgetanyapi-com/cli#17, makes the query optional:--categoryor--platformalone is a complete search.Two changes in
cli.mdx:anyapi search [query] [--category <category>] [--platform <platform>]and says the query is optional from 0.9.0.--category, and--platform, and ranking falls back from semantic to keyword when there is no query.Measured against production with no key:
langchain.mdxis deliberately untouched. Its "This tool requiresquery" line is still true:langchain-anyapideclaresquery: strin its own tool surface and needs its own release.Gates green locally:
scripts/check-docs-nav.sh,scripts/check-agent-contract.sh,mint validate.