diff --git a/README.md b/README.md
index d47dc09f..3da5dc41 100644
--- a/README.md
+++ b/README.md
@@ -130,6 +130,8 @@ mmx search "MiniMax AI"
 mmx search query --q "latest news" --output json
 ```
 
+> The `/v1/coding_plan/search` API returns at most 10 results per call and does not currently expose a pagination parameter (see #107). Refine your query if you need different results.
+
 ### `mmx auth`
 
 ```bash
diff --git a/README_CN.md b/README_CN.md
index ec9b6b48..6c0d3472 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -130,6 +130,8 @@ mmx search "MiniMax AI"
 mmx search query --q "最新动态" --output json
 ```
 
+> `/v1/coding_plan/search` 接口单次最多返回 10 条结果，目前不支持翻页参数（参见 #107）。如需不同结果，请调整查询关键词。
+
 ### `mmx auth`
 
 ```bash
diff --git a/SDK.md b/SDK.md
index 63dab5a7..41a14562 100644
--- a/SDK.md
+++ b/SDK.md
@@ -171,6 +171,8 @@ for (const item of results.organic) {
 }
 ```
 
+> The underlying `/v1/coding_plan/search` API returns at most 10 results per call and does not currently expose a pagination parameter (see #107). Refine your query if you need different results.
+
 ### Quota
 
 ```typescript
diff --git a/src/commands/search/query.ts b/src/commands/search/query.ts
index f7d85d9e..3331cfff 100644
--- a/src/commands/search/query.ts
+++ b/src/commands/search/query.ts
@@ -20,7 +20,11 @@ interface SearchResponse {
 
 export default defineCommand({
   name: 'search query',
-  description: 'Search the web via MiniMax',
+  description:
+    'Search the web via MiniMax. ' +
+    'Note: the underlying /v1/coding_plan/search API returns at most 10 ' +
+    'results per call and does not currently support pagination, so ' +
+    'refining your --q is the only way to see different results.',
   usage: 'mmx search query --q <query>',
   options: [
     { flag: '--q <query>', description: 'Search query string' },