fix: Return structured content for empty search results in search-apify-docs and store_collection (#371)

* fix: return structured content for empty search results in search-apify-docs and store_collection

Author: jirispilka

AGENTS.md

@@ -90,11 +90,11 @@ Once configured, the server exposes tools that become available to the coding ag
 2. **Verify connection**: The client should connect and list available tools automatically
 3. **Tools are now available**: Once connected, all MCP tools are exposed and ready to use
 
-#### 2. Coding agent testing workflow
+#### 2. Coding agent for MCP server testing
 
-**Note**: Only execute this testing workflow when explicitly requested by the user.
+**Note**: Only execute the tests when explicitly requested by the user.
 
-Once the server is configured, test the MCP tools by:
+Once the MCP server is configured, test the MCP tools by:
 
 1. **Invoke each tool** through the MCP client (e.g., ask the AI agent to "search for actors" or "fetch actor details for apify/rag-web-browser")
 2. **Test with valid inputs** (happy path) – verify outputs match expected formats

src/tools/search-apify-docs.ts

@@ -67,12 +67,19 @@ USAGE EXAMPLES:
         const results = resultsRaw.slice(parsed.offset, parsed.offset + parsed.limit);
 
         if (results.length === 0) {
-            return buildMCPResponse({ texts: [`No results found for the query "${query}" with limit ${parsed.limit} and offset ${parsed.offset}.
-Please try a different query with different keywords, or adjust the limit and offset parameters.
-You can also try using more specific or alternative keywords related to your search topic.`] });
+            const instructions = `No results found for the query "${query}" with limit ${parsed.limit} and offset ${parsed.offset}.
+Try a different query with different keywords, or adjust the limit and offset parameters.
+You can also try using more specific or alternative keywords related to your search topic.`;
+            const structuredContent = {
+                results: [],
+                query,
+                count: 0,
+                instructions,
+            };
+            return buildMCPResponse({ texts: [instructions], structuredContent });
         }
 
-        const textContent = `You can use the Apify docs fetch tool to retrieve the full content of a document by its URL. The document fragment refers to the section of the content containing the relevant part for the search result item.
+        const instructions = `You can use the Apify docs fetch tool to retrieve the full content of a document by its URL. The document fragment refers to the section of the content containing the relevant part for the search result item.
 Search results for "${query}":
 
 ${results.map((result) => `- Document URL: ${result.url}${result.fragment ? `\n  Document fragment: ${result.fragment}` : ''}
@@ -84,8 +91,10 @@ ${results.map((result) => `- Document URL: ${result.url}${result.fragment ? `\n
                 fragment: result.fragment,
                 content: result.content,
             })),
-            instructions: `You can use the Apify docs fetch tool to retrieve the full content of a document by its URL. The document fragment refers to the section of the content containing the relevant part for the search result item.`,
+            query,
+            count: results.length,
+            instructions,
         };
-        return buildMCPResponse({ texts: [textContent], structuredContent });
+        return buildMCPResponse({ texts: [instructions], structuredContent });
     },
 } as const;

src/tools/store_collection.ts

@@ -145,16 +145,24 @@ Returns list of Actor cards with the following info:
         const actorCards = actors.length === 0 ? [] : actors.map(formatActorToActorCard);
 
         if (actorCards.length === 0) {
-            return buildMCPResponse({ texts: [`No Actors were found for the search query "${parsed.keywords}".
- Please try different keywords or simplify your query. Consider using more specific platform names (e.g., "Instagram", "Twitter") and data types (e.g., "posts", "products") rather than generic terms like "scraper" or "crawler".`] });
+            const instructions = `No Actors were found for the search query "${parsed.keywords}".
+Try a different query with different keywords, or adjust the limit and offset parameters.
+You can also try using more specific or alternative keywords related to your search topic.`;
+            const structuredContent = {
+                actors: [],
+                query: parsed.keywords,
+                count: 0,
+                instructions,
+            };
+            return buildMCPResponse({ texts: [instructions], structuredContent });
         }
 
         const actorsText = actorCards.join('\n\n');
 
         // Generate structured cards for the actors
         const structuredActorCards = actors.map(formatActorToStructuredCard);
 
-        const texts = [`
+        const instructions = `
  # Search results:
  - **Search query:** ${parsed.keywords}
  - **Number of Actors found:** ${actorCards.length}
@@ -165,16 +173,15 @@ Returns list of Actor cards with the following info:
 
  If you need more detailed information about any of these Actors, including their input schemas and usage instructions, please use the ${HelperTools.ACTOR_GET_DETAILS} tool with the specific Actor name.
  If the search did not return relevant results, consider refining your keywords, use broader terms or removing less important words from the keywords.
- `];
+ `;
 
         const structuredContent = {
             actors: structuredActorCards,
             query: parsed.keywords,
             count: actorCards.length,
-            instructions: `If you need more detailed information about any of these Actors, including their input schemas and usage instructions, please use the ${HelperTools.ACTOR_GET_DETAILS} tool with the specific Actor name.
- If the search did not return relevant results, consider refining your keywords, use broader terms or removing less important words from the keywords.`,
+            instructions,
         };
 
-        return buildMCPResponse({ texts, structuredContent });
+        return buildMCPResponse({ texts: [instructions], structuredContent });
     },
 } as const;