{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_cs48zgkesjdg","handle":"spider-mcp-client","url":"https://wellknown.network/agents/spider-mcp-client","links":{"self":"https://wellknown.network/agents/spider-mcp-client/record.json","html":"https://wellknown.network/agents/spider-mcp-client","markdown":"https://wellknown.network/agents/spider-mcp-client/record.md","api":"https://wellknown.network/api/v1/agents/spider-mcp-client","status":"https://wellknown.network/api/v1/agents/spider-mcp-client/status","claim":"https://wellknown.network/agents/spider-mcp-client/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/spider-mcp-client/claim.json","badge":"https://wellknown.network/agents/spider-mcp-client/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:spider-mcp-client","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"spider-mcp-client","summary":"Official Python client for Spider MCP web scraping API","description":"# Spider MCP Client\n\n[![PyPI version](https://badge.fury.io/py/spider-mcp-client.svg)](https://badge.fury.io/py/spider-mcp-client)\n[![Python Support](https://img.shields.io/pypi/pyversions/spider-mcp-client.svg)](https://pypi.org/project/spider-mcp-client/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nOfficial Python client for **Spider MCP** - a professional web scraping API with advanced anti-detection capabilities.\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\npip install spider-mcp-client\n```\n\n### Basic Usage\n\n```python\nfrom spider_mcp_client import SpiderMCPClient\n\n# Initialize client\nclient = SpiderMCPClient(\n    api_key=\"your-api-key-here\",\n    base_url=\"http://localhost:8003\"  # Your Spider MCP server\n)\n\n# Parse a URL\nresult = client.parse_url(\"https://example.com/article\")\n\nprint(f\"Status: {result['status']}\")\nprint(f\"Title: {result['html_data'].get('title', 'N/A')}\")\nprint(f\"Parser: {result['status_detail']['parser_used']}\")\nprint(f\"API Calls: {len(result['api_calls'])}\")\nprint(f\"Images: {len(result['downloaded_images'])}\")\n```\n\n## 📋 Features\n\n- ✅ **Simple API** - One method to parse any supported URL\n- ✅ **Built-in retry logic** - Automatic retries with exponential backoff\n- ✅ **Rate limiting** - Respectful delays between requests\n- ✅ **Error handling** - Clear exceptions for different error types\n- ✅ **Image support** - Optional image download and localization\n- ✅ **Session isolation** - Multiple isolated browser sessions\n- ✅ **Type hints** - Full typing support for better IDE experience\n\n## 🔧 API Reference\n\n### SpiderMCPClient\n\n```python\nclient = SpiderMCPClient(\n    api_key=\"your-api-key\",           # Required: Your API key\n    base_url=\"http://localhost:8003\", # Spider MCP server URL\n    timeout=30,                       # Request timeout (seconds)\n    max_retries=3,                    # Max retry attempts\n    rate_limit_delay=1.0             # Delay between requests (seconds)\n)\n```\n\n#…","publisher":{"name":"Spider MCP Team","url":null},"homepage":"https://github.com/spider-mcp/spider-mcp-client","repository":"https://github.com/xychenmsn/spider-mcp-client/issues","version":"0.1.8","license":"MIT","protocols":["mcp"],"tags":["web","scraping","spider","mcp","api","client","html","parsing","data","extraction"],"pricing":null,"endpoints":[{"url":"pypi:spider-mcp-client","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"data.web-scraping","name":"Web Scraping","confidence":1,"provenance":"declared"},{"slug":"documents.extraction","name":"Data Extraction","confidence":1,"provenance":"declared"},{"slug":"research.web","name":"Deep Web Research","confidence":1,"provenance":"declared"}],"categories":["data","documents","research"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"spider-mcp-client","registry":"pypi","observedAt":"2026-09-10T13:21:23.731Z","publishedAt":"2025-09-25T22:26:58.850949Z","latestVersion":"0.1.8"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"spider-mcp-client","url":"https://pypi.org/project/spider-mcp-client/","firstSeenAt":"2026-09-10T13:19:09.093Z","fetchedAt":"2026-09-10T13:19:09.093Z","normalizedAt":"2026-09-10T13:19:09.093Z"}]},"firstSeenAt":"2026-09-10T13:19:09.093Z","updatedAt":"2026-09-10T13:21:23.731Z"}