docs(search): document the 10-result cap on mmx search query (#107)#170
Open
TumCucTom wants to merge 1 commit into
Open
docs(search): document the 10-result cap on mmx search query (#107)#170TumCucTom wants to merge 1 commit into
TumCucTom wants to merge 1 commit into
Conversation
The /v1/coding_plan/search endpoint does not currently expose any
pagination parameter (verified against the canonical reference
client at MiniMax-AI/MiniMax-Coding-Plan-MCP/minimax_mcp/server.py,
whose web_search tool only sends {"q": query}). The 10-result cap
is therefore a hard API limit, not a CLI limitation.
Issue MiniMax-AI#107 asked for pagination, but adding --page / --limit
flags to the CLI would not actually paginate — the server would
ignore them. So this PR is docs-only:
- src/commands/search/query.ts: extend the command's --help
description to call out the 10-result cap and the fact that
refining --q is the only way to see different results.
- README.md, README_CN.md, SDK.md: add a short note next to
the search section making the cap visible to users.
The actual fix has to come from the API. A follow-up issue
has been filed at MiniMax-AI#169 tracking the API-side work
needed to make --page and --limit viable.
Refs MiniMax-AI#107.
Co-authored-by: Zippy AI <tomkinsbale@icloud.com>
Co-Authored-By: Claude Opus 4.7 <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.
Summary
mmx search query'sdescriptionnow spells out the 10-result cap and tells users to refine--qif they need different results.README.md,README_CN.md, andSDK.mdget a short note next to the search section making the cap visible.Why this is a docs-only PR
I investigated the
/v1/coding_plan/searchendpoint before writing code. The canonical reference client isMiniMax-AI/MiniMax-Coding-Plan-MCP/minimax_mcp/server.py, whereweb_search(query: str)only sends{"q": query}. The response is{ organic: [...], related_searches: [...] }— nocount,page,limit, oroffsetis accepted or returned.In other words, the 10-result cap is a hard API limit, not a CLI limitation. Adding
--page/--limitflags to the CLI would not actually paginate — the server would ignore them. So this PR is intentionally docs-only.A follow-up issue has been filed at #169 tracking the API-side work needed to make pagination viable.
Changes
src/commands/search/query.ts— extend the command'sdescription(shown in--help) to call out the 10-result cap.README.md/README_CN.md— add a one-line note in themmx searchsection.SDK.md— add the same note in the Search subsection.Test plan
bun test— 355 pass, 0 failbun run typecheck— cleanbun run lint— only the 2 pre-existing errors onupstream/main(unrelated to this PR)Refs #107.