@apify/actors-mcp-server 0.2.10-beta.1 → 0.2.10-beta.2

package/README.md

@@ -92,10 +92,8 @@ You can refer to the specific Actor's documentation for a list of available argu
 ### Helper tools
 One of the powerful features of MCP with Apify is dynamic actor tooling – the ability for an AI agent to find new tools (Actors) as needed and incorporate them. Here are some special MCP operations and how Apify MCP Server supports them:
 
-- Actor discovery and management: Search for Actors (`search-actors`), view details (`get-actor-details`), and dynamically add or remove tools (`add-actor`, `remove-actor`).
-- Actor execution and monitoring: Start Actor runs, fetch run results (`get-actor-run`), logs (`get-actor-log`), and abort runs (`abort-actor-run`).
-- Dataset access: List datasets, retrieve dataset info and items (`get-dataset`, `get-dataset-list`, `get-dataset-items`).
-- Key-value store access: List key-value stores, view keys, and retrieve records (`get-key-value-store-list`, `get-key-value-store`, `get-key-value-store-keys`, `get-key-value-store-record`).
+- Actor discovery and management: Search for Actors (`search-actors`), view details (`get-actor-details`), and dynamically add them (`add-actor`).
+- Apify documentation: Search Apify documentation (`search-apify-docs`) and fetch specific documents (`fetch-apify-docs`).
 - Built-in help tool: A static helper (`apify-actor-help-tool`) that returns usage info for the Apify MCP Server.
 
 ## Prompt & Resources

package/dist/const.d.ts

@@ -24,7 +24,9 @@ export declare enum HelperTools {
     KEY_VALUE_STORE_KEYS_GET = "get-key-value-store-keys",
     KEY_VALUE_STORE_RECORD_GET = "get-key-value-store-record",
     APIFY_MCP_HELP_TOOL = "apify-actor-help-tool",
-    STORE_SEARCH = "search-actors"
+    STORE_SEARCH = "search-actors",
+    DOCS_SEARCH = "search-apify-docs",
+    DOCS_FETCH = "fetch-apify-docs"
 }
 export declare const defaults: {
     actors: string[];
@@ -34,6 +36,8 @@ export declare const ACTOR_OUTPUT_TRUNCATED_MESSAGE: string;
 export declare const ACTOR_ADDITIONAL_INSTRUCTIONS = "Never call/execute tool/Actor unless confirmed by the user.";
 export declare const ACTOR_CACHE_MAX_SIZE = 500;
 export declare const ACTOR_CACHE_TTL_SECS: number;
+export declare const APIFY_DOCS_CACHE_MAX_SIZE = 500;
+export declare const APIFY_DOCS_CACHE_TTL_SECS: number;
 export declare const ACTOR_PRICING_MODEL: {
     /** Rental actors */
     readonly FLAT_PRICE_PER_MONTH: "FLAT_PRICE_PER_MONTH";
@@ -49,4 +53,9 @@ export declare const ACTOR_PRICING_MODEL: {
  */
 export declare const ACTOR_SEARCH_ABOVE_LIMIT = 50;
 export declare const MCP_STREAMABLE_ENDPOINT = "/mcp";
+export declare const ALGOLIA: {
+    appId: string;
+    apiKey: string;
+    indexName: string;
+};
 //# sourceMappingURL=const.d.ts.map

package/dist/const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../src/const.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAGpD,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAG7C,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAC9C,eAAO,MAAM,cAAc,UAAU,CAAC;AAGtC,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,oBAAY,WAAW;IACnB,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,iBAAiB,sBAAsB;IACvC,YAAY,iBAAiB;IAC7B,gBAAgB,oBAAoB;IACpC,cAAc,kBAAkB;IAChC,cAAc,kBAAkB;IAChC,kBAAkB,uBAAuB;IACzC,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,wBAAwB,6BAA6B;IACrD,mBAAmB,wBAAwB;IAC3C,wBAAwB,6BAA6B;IACrD,0BAA0B,+BAA+B;IACzD,mBAAmB,0BAA0B;IAC7C,YAAY,kBAAkB;CACjC;AAED,eAAO,MAAM,QAAQ;;CAIpB,CAAC;AAGF,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AACrD,eAAO,MAAM,8BAA8B,QAC8F,CAAC;AAE1I,eAAO,MAAM,6BAA6B,gEAAgE,CAAC;AAE3G,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,oBAAoB,QAAU,CAAC;AAE5C,eAAO,MAAM,mBAAmB;IAC5B,oBAAoB;;;IAGpB,kCAAkC;;IAElC,iCAAiC;;CAE3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,eAAO,MAAM,uBAAuB,SAAS,CAAC"}
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../src/const.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAGpD,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAG7C,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAC9C,eAAO,MAAM,cAAc,UAAU,CAAC;AAGtC,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,oBAAY,WAAW;IACnB,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,iBAAiB,sBAAsB;IACvC,YAAY,iBAAiB;IAC7B,gBAAgB,oBAAoB;IACpC,cAAc,kBAAkB;IAChC,cAAc,kBAAkB;IAChC,kBAAkB,uBAAuB;IACzC,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,wBAAwB,6BAA6B;IACrD,mBAAmB,wBAAwB;IAC3C,wBAAwB,6BAA6B;IACrD,0BAA0B,+BAA+B;IACzD,mBAAmB,0BAA0B;IAC7C,YAAY,kBAAkB;IAC9B,WAAW,sBAAsB;IACjC,UAAU,qBAAqB;CAClC;AAED,eAAO,MAAM,QAAQ;;CAIpB,CAAC;AAGF,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AACrD,eAAO,MAAM,8BAA8B,QAC8F,CAAC;AAE1I,eAAO,MAAM,6BAA6B,gEAAgE,CAAC;AAG3G,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,oBAAoB,QAAU,CAAC;AAC5C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,yBAAyB,QAAU,CAAC;AAEjD,eAAO,MAAM,mBAAmB;IAC5B,oBAAoB;;;IAGpB,kCAAkC;;IAElC,iCAAiC;;CAE3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAE9C,eAAO,MAAM,OAAO;;;;CAInB,CAAC"}

package/dist/const.js

@@ -30,6 +30,8 @@ export var HelperTools;
     HelperTools["KEY_VALUE_STORE_RECORD_GET"] = "get-key-value-store-record";
     HelperTools["APIFY_MCP_HELP_TOOL"] = "apify-actor-help-tool";
     HelperTools["STORE_SEARCH"] = "search-actors";
+    HelperTools["DOCS_SEARCH"] = "search-apify-docs";
+    HelperTools["DOCS_FETCH"] = "fetch-apify-docs";
 })(HelperTools || (HelperTools = {}));
 export const defaults = {
     actors: [
@@ -41,8 +43,11 @@ export const ACTOR_OUTPUT_MAX_CHARS_PER_ITEM = 5000;
 export const ACTOR_OUTPUT_TRUNCATED_MESSAGE = `Output was truncated because it will not fit into context.`
     + `There is no reason to call this tool again! You can use ${HelperTools.DATASET_GET_ITEMS} tool to get more items from the dataset.`;
 export const ACTOR_ADDITIONAL_INSTRUCTIONS = 'Never call/execute tool/Actor unless confirmed by the user.';
+// Cache
 export const ACTOR_CACHE_MAX_SIZE = 500;
 export const ACTOR_CACHE_TTL_SECS = 30 * 60; // 30 minutes
+export const APIFY_DOCS_CACHE_MAX_SIZE = 500;
+export const APIFY_DOCS_CACHE_TTL_SECS = 60 * 60; // 1 hour
 export const ACTOR_PRICING_MODEL = {
     /** Rental actors */
     FLAT_PRICE_PER_MONTH: 'FLAT_PRICE_PER_MONTH',
@@ -58,4 +63,9 @@ export const ACTOR_PRICING_MODEL = {
  */
 export const ACTOR_SEARCH_ABOVE_LIMIT = 50;
 export const MCP_STREAMABLE_ENDPOINT = '/mcp';
+export const ALGOLIA = {
+    appId: 'N8EOCSBQGH',
+    apiKey: 'e97714a64e2b4b8b8fe0b01cd8592870', // search only (public) API key
+    indexName: 'test_test_apify_sdk',
+};
 //# sourceMappingURL=const.js.map

package/dist/const.js.map

@@ -1 +1 @@
-{"version":3,"file":"const.js","sourceRoot":"","sources":["../src/const.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAK,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AAEpD,kBAAkB;AAClB,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAK,CAAC,CAAC,kGAAkG;AAEhJ,aAAa;AACb,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,qBAAqB;AACrB,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAErD,MAAM,CAAN,IAAY,WAmBX;AAnBD,WAAY,WAAW;IACnB,sCAAuB,CAAA;IACvB,wCAAyB,CAAA;IACzB,sCAAuB,CAAA;IACvB,sDAAuC,CAAA;IACvC,4CAA6B,CAAA;IAC7B,mDAAoC,CAAA;IACpC,+CAAgC,CAAA;IAChC,+CAAgC,CAAA;IAChC,wDAAyC,CAAA;IACzC,0CAA2B,CAAA;IAC3B,oDAAqC,CAAA;IACrC,sDAAuC,CAAA;IACvC,oEAAqD,CAAA;IACrD,0DAA2C,CAAA;IAC3C,oEAAqD,CAAA;IACrD,wEAAyD,CAAA;IACzD,4DAA6C,CAAA;IAC7C,6CAA8B,CAAA;AAClC,CAAC,EAnBW,WAAW,KAAX,WAAW,QAmBtB;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,MAAM,EAAE;QACJ,uBAAuB;KAC1B;CACJ,CAAC;AAEF,qBAAqB;AACrB,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAK,CAAC;AACrD,MAAM,CAAC,MAAM,8BAA8B,GAAG,4DAA4D;MACpG,2DAA2D,WAAW,CAAC,iBAAiB,2CAA2C,CAAC;AAE1I,MAAM,CAAC,MAAM,6BAA6B,GAAG,6DAA6D,CAAC;AAE3G,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,aAAa;AAE1D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,oBAAoB;IACpB,oBAAoB,EAAE,sBAAsB;IAC5C,IAAI,EAAE,MAAM;IACZ,kCAAkC;IAClC,sBAAsB,EAAE,wBAAwB;IAChD,iCAAiC;IACjC,aAAa,EAAE,eAAe;CACxB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC"}
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../src/const.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAK,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAEhD,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AAEpD,kBAAkB;AAClB,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAK,CAAC,CAAC,kGAAkG;AAEhJ,aAAa;AACb,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,qBAAqB;AACrB,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAErD,MAAM,CAAN,IAAY,WAqBX;AArBD,WAAY,WAAW;IACnB,sCAAuB,CAAA;IACvB,wCAAyB,CAAA;IACzB,sCAAuB,CAAA;IACvB,sDAAuC,CAAA;IACvC,4CAA6B,CAAA;IAC7B,mDAAoC,CAAA;IACpC,+CAAgC,CAAA;IAChC,+CAAgC,CAAA;IAChC,wDAAyC,CAAA;IACzC,0CAA2B,CAAA;IAC3B,oDAAqC,CAAA;IACrC,sDAAuC,CAAA;IACvC,oEAAqD,CAAA;IACrD,0DAA2C,CAAA;IAC3C,oEAAqD,CAAA;IACrD,wEAAyD,CAAA;IACzD,4DAA6C,CAAA;IAC7C,6CAA8B,CAAA;IAC9B,gDAAiC,CAAA;IACjC,8CAA+B,CAAA;AACnC,CAAC,EArBW,WAAW,KAAX,WAAW,QAqBtB;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,MAAM,EAAE;QACJ,uBAAuB;KAC1B;CACJ,CAAC;AAEF,qBAAqB;AACrB,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAK,CAAC;AACrD,MAAM,CAAC,MAAM,8BAA8B,GAAG,4DAA4D;MACpG,2DAA2D,WAAW,CAAC,iBAAiB,2CAA2C,CAAC;AAE1I,MAAM,CAAC,MAAM,6BAA6B,GAAG,6DAA6D,CAAC;AAE3G,QAAQ;AACR,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,aAAa;AAC1D,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAC7C,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS;AAE3D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,oBAAoB;IACpB,oBAAoB,EAAE,sBAAsB;IAC5C,IAAI,EAAE,MAAM;IACZ,kCAAkC;IAClC,sBAAsB,EAAE,wBAAwB;IAChD,iCAAiC;IACjC,aAAa,EAAE,eAAe;CACxB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAE9C,MAAM,CAAC,MAAM,OAAO,GAAG;IACnB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,kCAAkC,EAAE,+BAA+B;IAC3E,SAAS,EAAE,qBAAqB;CACnC,CAAC"}

package/dist/state.d.ts

@@ -1,4 +1,7 @@
-import type { ActorDefinitionPruned } from './types.js';
+import type { ActorDefinitionPruned, ApifyDocsSearchResult } from './types.js';
 import { TTLLRUCache } from './utils/ttl-lru.js';
 export declare const actorDefinitionPrunedCache: TTLLRUCache<ActorDefinitionPruned>;
+export declare const searchApifyDocsCache: TTLLRUCache<ApifyDocsSearchResult[]>;
+/** Stores processed Markdown content */
+export declare const fetchApifyDocsCache: TTLLRUCache<string>;
 //# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,eAAO,MAAM,0BAA0B,oCAAqF,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,eAAO,MAAM,0BAA0B,oCAAqF,CAAC;AAC7H,eAAO,MAAM,oBAAoB,sCAAiG,CAAC;AACnI,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,qBAAgF,CAAC"}

package/dist/state.js

@@ -1,4 +1,7 @@
-import { ACTOR_CACHE_MAX_SIZE, ACTOR_CACHE_TTL_SECS } from './const.js';
+import { ACTOR_CACHE_MAX_SIZE, ACTOR_CACHE_TTL_SECS, APIFY_DOCS_CACHE_MAX_SIZE, APIFY_DOCS_CACHE_TTL_SECS } from './const.js';
 import { TTLLRUCache } from './utils/ttl-lru.js';
 export const actorDefinitionPrunedCache = new TTLLRUCache(ACTOR_CACHE_MAX_SIZE, ACTOR_CACHE_TTL_SECS);
+export const searchApifyDocsCache = new TTLLRUCache(APIFY_DOCS_CACHE_MAX_SIZE, APIFY_DOCS_CACHE_TTL_SECS);
+/** Stores processed Markdown content */
+export const fetchApifyDocsCache = new TTLLRUCache(APIFY_DOCS_CACHE_MAX_SIZE, APIFY_DOCS_CACHE_TTL_SECS);
 //# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,WAAW,CAAwB,oBAAoB,EAAE,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE9H,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,WAAW,CAAwB,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;AAC7H,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,WAAW,CAA0B,yBAAyB,EAAE,yBAAyB,CAAC,CAAC;AACnI,wCAAwC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,WAAW,CAAS,yBAAyB,EAAE,yBAAyB,CAAC,CAAC"}

package/dist/tools/fetch-apify-docs.d.ts

@@ -0,0 +1,3 @@
+import type { ToolEntry } from '../types.js';
+export declare const fetchApifyDocsTool: ToolEntry;
+//# sourceMappingURL=fetch-apify-docs.d.ts.map

package/dist/tools/fetch-apify-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-apify-docs.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-apify-docs.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,aAAa,CAAC;AAU3D,eAAO,MAAM,kBAAkB,EAAE,SA+DhC,CAAC"}

package/dist/tools/fetch-apify-docs.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import zodToJsonSchema from 'zod-to-json-schema';
+import log from '@apify/log';
+import { HelperTools } from '../const.js';
+import { fetchApifyDocsCache } from '../state.js';
+import { ajv } from '../utils/ajv.js';
+import { htmlToMarkdown } from '../utils/html-to-md.js';
+const fetchApifyDocsToolArgsSchema = z.object({
+    url: z.string()
+        .min(1)
+        .describe(`URL of the Apify documentation page to fetch. This should be the full URL, including the protocol (e.g., https://docs.apify.com/).`),
+});
+export const fetchApifyDocsTool = {
+    type: 'internal',
+    tool: {
+        name: HelperTools.DOCS_FETCH,
+        description: `Apify documentation fetch tool. This tool allows you to fetch the full content of an Apify documentation page by its URL.`,
+        args: fetchApifyDocsToolArgsSchema,
+        inputSchema: zodToJsonSchema(fetchApifyDocsToolArgsSchema),
+        ajvValidate: ajv.compile(zodToJsonSchema(fetchApifyDocsToolArgsSchema)),
+        call: async (toolArgs) => {
+            const { args } = toolArgs;
+            const parsed = fetchApifyDocsToolArgsSchema.parse(args);
+            const url = parsed.url.trim();
+            const urlWithoutFragment = url.split('#')[0];
+            // Only allow URLs starting with https://docs.apify.com
+            if (!url.startsWith('https://docs.apify.com')) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Only URLs starting with https://docs.apify.com are allowed.`,
+                        }],
+                };
+            }
+            // Cache URL without fragment to avoid fetching the same page multiple times
+            let markdown = fetchApifyDocsCache.get(urlWithoutFragment);
+            // If the content is not cached, fetch it from the URL
+            if (!markdown) {
+                try {
+                    const response = await fetch(url);
+                    if (!response.ok) {
+                        return {
+                            content: [{
+                                    type: 'text',
+                                    text: `Failed to fetch the documentation page at ${url}. Status: ${response.status} ${response.statusText}`,
+                                }],
+                        };
+                    }
+                    const html = await response.text();
+                    markdown = htmlToMarkdown(html);
+                    // Cache the processed Markdown content
+                    // Use the URL without fragment as the key to avoid caching same page with different fragments
+                    fetchApifyDocsCache.set(urlWithoutFragment, markdown);
+                }
+                catch (error) {
+                    log.error(`Failed to fetch the documentation page at ${url}.`, { error });
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `Failed to fetch the documentation page at ${url}. Please check the URL and try again.`,
+                            }],
+                    };
+                }
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Fetched content from ${url}:\n\n${markdown}`,
+                    }],
+            };
+        },
+    },
+};
+//# sourceMappingURL=fetch-apify-docs.js.map

package/dist/tools/fetch-apify-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-apify-docs.js","sourceRoot":"","sources":["../../src/tools/fetch-apify-docs.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9E,OAAO,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AAGjD,eAAO,MAAM,YAAY,mCAkBxB,CAAC;AAEF,eAAO,MAAM,cAAc,mCAG1B,CAAC;AAGF,OAAO,EACH,OAAO,EAEP,gBAAgB,EAChB,mBAAmB,GACtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9E,OAAO,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AAIjD,eAAO,MAAM,YAAY,mCAoBxB,CAAC;AAEF,eAAO,MAAM,cAAc,mCAG1B,CAAC;AAGF,OAAO,EACH,OAAO,EAEP,gBAAgB,EAChB,mBAAmB,GACtB,CAAC"}

package/dist/tools/index.js

@@ -1,7 +1,9 @@
 // Import specific tools that are being used
 import { callActor, callActorGetDataset, getActorsAsTools } from './actor.js';
+import { fetchApifyDocsTool } from './fetch-apify-docs.js';
 import { getActorDetailsTool } from './get-actor-details.js';
 import { addTool, helpTool } from './helpers.js';
+import { searchApifyDocsTool } from './search-apify-docs.js';
 import { searchActors } from './store_collection.js';
 export const defaultTools = [
     // abortActorRun,
@@ -21,6 +23,8 @@ export const defaultTools = [
     getActorDetailsTool,
     helpTool,
     searchActors,
+    searchApifyDocsTool,
+    fetchApifyDocsTool,
 ];
 export const addRemoveTools = [
     addTool,

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,iBAAiB;IACjB,oBAAoB;IACpB,YAAY;IACZ,eAAe;IACf,eAAe;IACf,cAAc;IACd,mBAAmB;IACnB,oBAAoB;IACpB,wBAAwB;IACxB,0BAA0B;IAC1B,mBAAmB;IACnB,uBAAuB;IACvB,6BAA6B;IAC7B,SAAS;IACT,mBAAmB;IACnB,QAAQ;IACR,YAAY;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,OAAO;IACP,cAAc;CACjB,CAAC;AAEF,4CAA4C;AAC5C,OAAO,EACH,OAAO;AACP,cAAc;AACd,gBAAgB,EAChB,mBAAmB,GACtB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,iBAAiB;IACjB,oBAAoB;IACpB,YAAY;IACZ,eAAe;IACf,eAAe;IACf,cAAc;IACd,mBAAmB;IACnB,oBAAoB;IACpB,wBAAwB;IACxB,0BAA0B;IAC1B,mBAAmB;IACnB,uBAAuB;IACvB,6BAA6B;IAC7B,SAAS;IACT,mBAAmB;IACnB,QAAQ;IACR,YAAY;IACZ,mBAAmB;IACnB,kBAAkB;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,OAAO;IACP,cAAc;CACjB,CAAC;AAEF,4CAA4C;AAC5C,OAAO,EACH,OAAO;AACP,cAAc;AACd,gBAAgB,EAChB,mBAAmB,GACtB,CAAC"}

package/dist/tools/search-apify-docs.d.ts

@@ -0,0 +1,3 @@
+import type { ToolEntry } from '../types.js';
+export declare const searchApifyDocsTool: ToolEntry;
+//# sourceMappingURL=search-apify-docs.d.ts.map

package/dist/tools/search-apify-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-apify-docs.d.ts","sourceRoot":"","sources":["../../src/tools/search-apify-docs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,aAAa,CAAC;AAwB3D,eAAO,MAAM,mBAAmB,EAAE,SAyCjC,CAAC"}

package/dist/tools/search-apify-docs.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import zodToJsonSchema from 'zod-to-json-schema';
+import { HelperTools } from '../const.js';
+import { ajv } from '../utils/ajv.js';
+import { searchApifyDocsCached } from '../utils/apify-docs.js';
+const searchApifyDocsToolArgsSchema = z.object({
+    query: z.string()
+        .min(1)
+        .describe(`Algolia full-text search query to find relevant documentation pages.
+Use only keywords, do not use full sentences or questions.
+For example, "standby actor" will return documentation pages that contain the words "standby" and "actor".`),
+    limit: z.number()
+        .optional()
+        .default(5)
+        .describe(`Maximum number of search results to return. Defaults to 5.
+You can increase this limit if you need more results, but keep in mind that the search results are limited to the most relevant pages.`),
+    offset: z.number()
+        .optional()
+        .default(0)
+        .describe(`Offset for the search results. Defaults to 0.
+Use this to paginate through the search results. For example, if you want to get the next 5 results, set the offset to 5 and limit to 5.`),
+});
+export const searchApifyDocsTool = {
+    type: 'internal',
+    tool: {
+        name: HelperTools.DOCS_SEARCH,
+        description: `Apify documentation search tool. This tool allows you to search the Apify documentation using Algolia's full-text search.
+You can use it to find relevant documentation pages based on keywords. The results will include the URL of the documentation page, a fragment identifier (if available), and a limited piece of content that matches the search query. You can then fetch the full content of the document using the ${HelperTools.DOCS_FETCH} tool by providing the URL.
+Use this tool when a user asks for help with Apify documentation or when you need to find relevant documentation pages based on keywords. For example, when a user wants to build an Apify Actor, you can search "How to build Actors" to find relevant guidance.`,
+        args: searchApifyDocsToolArgsSchema,
+        inputSchema: zodToJsonSchema(searchApifyDocsToolArgsSchema),
+        ajvValidate: ajv.compile(zodToJsonSchema(searchApifyDocsToolArgsSchema)),
+        call: async (toolArgs) => {
+            const { args } = toolArgs;
+            const parsed = searchApifyDocsToolArgsSchema.parse(args);
+            const query = parsed.query.trim();
+            const resultsRaw = await searchApifyDocsCached(query);
+            const results = resultsRaw.slice(parsed.offset, parsed.offset + parsed.limit);
+            if (results.length === 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `No results found for the query "${query}" with limit ${parsed.limit} and offset ${parsed.offset}. Try a different query or adjust the limit and offset.`,
+                        }],
+                };
+            }
+            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.
+Search results for "${query}":
+                    
+${results.map((result) => `- Document URL: ${result.url}${result.fragment ? `\n  Document fragment: ${result.fragment}` : ''}
+  Content: ${result.content}`).join('\n\n')}`;
+            return {
+                content: [{
+                        type: 'text',
+                        text: textContent,
+                    }],
+            };
+        },
+    },
+};
+//# sourceMappingURL=search-apify-docs.js.map

package/dist/tools/search-apify-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-apify-docs.js","sourceRoot":"","sources":["../../src/tools/search-apify-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,eAAe,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACL;;2GAE+F,CAClG;IACL,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACZ,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC;uIACqH,CAAC;IACpI,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACb,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC;yIACuH,CAAC;CACzI,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAc;IAC1C,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE;QACF,IAAI,EAAE,WAAW,CAAC,WAAW;QAC7B,WAAW,EAAE;uSACkR,WAAW,CAAC,UAAU;kQAC3D;QAC1P,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,eAAe,CAAC,6BAA6B,CAAC;QAC3D,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,6BAA6B,CAAC,CAAC;QACxE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YACrB,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;YAE1B,MAAM,MAAM,GAAG,6BAA6B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAElC,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAE9E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO;oBACH,OAAO,EAAE,CAAC;4BACN,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,mCAAmC,KAAK,gBAAgB,MAAM,CAAC,KAAK,eAAe,MAAM,CAAC,MAAM,yDAAyD;yBAClK,CAAC;iBACL,CAAC;YACN,CAAC;YAED,MAAM,WAAW,GAAG;sBACV,KAAK;;EAEzB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,mBAAmB,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,0BAA0B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;aAC/G,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,OAAO;gBACH,OAAO,EAAE,CAAC;wBACN,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,WAAW;qBACpB,CAAC;aACL,CAAC;QACN,CAAC;KACY;CACpB,CAAC"}