{"id":26648331,"url":"https://github.com/tinyfish-io/agentql-mcp","last_synced_at":"2025-03-25T00:01:59.147Z","repository":{"id":282260346,"uuid":"906462272","full_name":"tinyfish-io/agentql-mcp","owner":"tinyfish-io","description":"Model Context Protocol server that integrates AgentQL's data extraction capabilities.","archived":false,"fork":false,"pushed_at":"2025-03-13T15:39:44.000Z","size":549,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-03-13T16:37:16.000Z","etag":null,"topics":["agent","agentql","ai","aiagent","claude","cursor","llm-tools","mcp","mcp-server","model-context-protocol","playwright","scraping","web","web-scraping","web-scrapping","webagent","windsurf"],"latest_commit_sha":null,"homepage":"https://docs.agentql.com/integrations/mcp","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tinyfish-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-21T01:12:55.000Z","updated_at":"2025-03-13T15:39:46.000Z","dependencies_parsed_at":"2025-03-13T16:37:41.783Z","dependency_job_id":null,"html_url":"https://github.com/tinyfish-io/agentql-mcp","commit_stats":null,"previous_names":["tinyfish-io/agentql-mcp"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinyfish-io%2Fagentql-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinyfish-io%2Fagentql-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinyfish-io%2Fagentql-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinyfish-io%2Fagentql-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tinyfish-io","download_url":"https://codeload.github.com/tinyfish-io/agentql-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245372377,"owners_count":20604491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agentql","ai","aiagent","claude","cursor","llm-tools","mcp","mcp-server","model-context-protocol","playwright","scraping","web","web-scraping","web-scrapping","webagent","windsurf"],"created_at":"2025-03-25T00:01:44.233Z","updated_at":"2025-03-25T00:01:59.078Z","avatar_url":"https://github.com/tinyfish-io.png","language":"JavaScript","readme":"# AgentQL MCP Server\n\nThis is a Model Context Protocol (MCP) server that integrates [AgentQL](https://agentql.com)'s data extraction capabilities.\n\n## Features\n\n### Tools\n\n- `extract-web-data` - extract structured data from a given 'url', using 'prompt' as a description of actual data and its fields to extract.\n\n## Installation\n\nTo use AgentQL MCP Server to extract data from web pages, you need to install it via npm, get an API key from our [Dev Portal](https://dev.agentql.com), and configure it in your favorite app that supports MCP.\n\n### Install the package\n\n```bash\nnpm install -g agentql-mcp\n```\n\n### Configure Claude\n\n- Open Claude Desktop **Settings** via `⌘`+`,` (don't confuse with Claude Account Settings)\n- Go to **Developer** sidebar section\n- Click **Edit Config** and open `claude_desktop_config.json` file\n- Add `agentql` server inside `mcpServers` dictionary in the config file\n- Restart the app\n\n```json title=\"claude_desktop_config.json\"\n{\n  \"mcpServers\": {\n    \"agentql\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentql-mcp\"],\n      \"env\": {\n        \"AGENTQL_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nRead more about MCP configuration in Claude [here](https://modelcontextprotocol.io/quickstart/user).\n\n### Configure Cursor\n\n- Open **Cursor Settings**\n- Go to **MCP \u003e MCP Servers**\n- Click **+ Add new MCP Server**\n- Enter the following:\n  - Name: \"agentql\" (or your preferred name)\n  - Type: \"command\"\n  - Command: `env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp`\n\nRead more about MCP configuration in Cursor [here](https://docs.cursor.com/context/model-context-protocol).\n\n### Configure Windsurf\n\n- Open **Windsurf: MCP Configuration Panel**\n- Click **Add custom server+**\n- Alternatively you can open `~/.codeium/windsurf/mcp_config.json` directly\n- Add `agentql` server inside `mcpServers` dictionary in the config file\n\n```json title=\"mcp_config.json\"\n{\n  \"mcpServers\": {\n    \"agentql\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"agentql-mcp\"],\n      \"env\": {\n        \"AGENTQL_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nRead more about MCP configuration in Windsurf [here](https://docs.codeium.com/windsurf/mcp).\n\n### Validate MCP integration\n\nGive your agent a task that will require extracting data from the web. For example:\n\n```text\nExtract the list of videos from the page https://www.youtube.com/results?search_query=agentql, every video should have a title, an author name, a number of views and a url to the video. Make sure to exclude ads items. Format this as a markdown table.\n```\n\n\u003e [!TIP]\n\u003e In case your agent complains that it can't open urls or load content from the web instead of using AgentQL, try adding \"use tools\" or \"use agentql tool\" hint.\n\n## Development\n\nInstall dependencies:\n\n```bash\nnpm install\n```\n\nBuild the server:\n\n```bash\nnpm run build\n```\n\nFor development with auto-rebuild:\n\n```bash\nnpm run watch\n```\n\nIf you want to try out development version, you can use the following config instead of the default one:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentql\": {\n      \"command\": \"/path/to/agentql-mcp/dist/index.js\",\n      \"env\": {\n        \"AGENTQL_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n\u003e [!NOTE]\n\u003e Don't forget to remove the default AgentQL MCP server config to not confuse Claude with two similar servers.\n\n## Debugging\n\nSince MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:\n\n```bash\nnpm run inspector\n```\n\nThe Inspector will provide a URL to access debugging tools in your browser.\n","funding_links":[],"categories":["Web Scraping","Data Access \u0026 Integration MCP Servers","MCP 服务器精选列表","📚 Projects (1974 total)","Production-Ready Servers","🤖 AI/ML","پیاده‌سازی‌های سرور","AI Services","官方 MCP 服务器列表","Official Servers","MCP Servers","Search \u0026 Data Extraction","APIs and HTTP Requests","🗂️ Extensions by Category","Table of Contents"],"sub_categories":["SIEM \u0026 SecOps","🔍 搜索","MCP Servers","🔎 \u003ca name=\"search\"\u003e\u003c/a\u003eجستجو و استخراج داده","🛠️ Other Tools and Integrations","How to Submit","🌐 Web Services","Other Tools and Integrations"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinyfish-io%2Fagentql-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftinyfish-io%2Fagentql-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinyfish-io%2Fagentql-mcp/lists"}