{ "openapi": "3.0.1", "info": { "title": "Tool Listing Auditor: Apify Actor & MCP Server SEO Audit", "description": "Audit an Apify Actor or MCP server listing for agent and Store search: metadata lint, simulated search rank for 10 task phrasings (BM25 + local embeddings), concrete rewrite suggestions, and a live MCP health check (initialize, tools/list, auth type). $0.50 per audit.", "version": "1.0", "x-build-id": "MnFlgxCD37Vz9J86j" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ventura_workalong~tool-listing-auditor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ventura_workalong-tool-listing-auditor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ventura_workalong~tool-listing-auditor/runs": { "post": { "operationId": "runs-sync-ventura_workalong-tool-listing-auditor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ventura_workalong~tool-listing-auditor/run-sync": { "post": { "operationId": "run-sync-ventura_workalong-tool-listing-auditor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "targets" ], "properties": { "targets": { "title": "Actors or MCP servers to audit", "type": "array", "description": "One target per line. An Apify Actor (`username/actor-name` or its `https://apify.com/...` URL), an official MCP Registry server name (`io.github.owner/server`), or a remote MCP server URL (`https://example.com/mcp`). Each audited target is one charge; targets that can't be audited are free.", "items": { "type": "string" } }, "taskQueries": { "title": "Your own task phrasings (optional)", "type": "array", "description": "Searches you expect users or AI agents to make when they need your tool, e.g. `extract all urls from a sitemap`. They are ranked in addition to the 10 phrasings generated from the listing. Up to 20.", "default": [], "items": { "type": "string" } }, "numGeneratedQueries": { "title": "Generated task phrasings", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many task phrasings to generate from the listing itself (title, description, README headings or tool names). Half reuse the listing's wording, half are paraphrases with synonyms.", "default": 10 }, "corpusSize": { "title": "Competitors per Store category", "minimum": 50, "maximum": 1000, "type": "integer", "description": "For Actors: the reference corpus is the N most popular Store Actors in each of the target's categories (deduplicated). For MCP servers the corpus is the official MCP Registry (all active servers).", "default": 300 }, "checkStoreSearch": { "title": "Also check real Apify Store search position", "type": "boolean", "description": "For Actors: look up the target's actual position (top 100) in Apify Store search for each task phrasing, next to the simulated rank. Uses the public Store API, one request per phrasing.", "default": true }, "healthCheck": { "title": "Live MCP health check", "type": "boolean", "description": "For MCP servers with a remote URL: call `initialize` and `tools/list` and report latency, protocol version and auth type. No credentials are ever sent, so servers that require auth report their auth method only.", "default": true }, "requestTimeoutSecs": { "title": "MCP request timeout (seconds)", "minimum": 3, "maximum": 60, "type": "integer", "description": "Timeout for each live MCP request.", "default": 15 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }