dataify-sdk 0.1.0__py3-none-any.whl

dataify_mcp/types/_mcp.py

@@ -0,0 +1,89 @@
+"""MCP protocol type definitions.
+
+These map to the JSON-RPC 2.0 structures used by the Model Context Protocol.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any
+
+
+@dataclass
+class JSONRPCRequest:
+    """A JSON-RPC 2.0 request."""
+
+    method: str
+    params: dict[str, Any] | None = None
+    jsonrpc: str = "2.0"
+    id: int = 0
+
+
+@dataclass
+class JSONRPCError:
+    """A JSON-RPC 2.0 error object."""
+
+    code: int
+    message: str
+    data: Any = None
+
+
+@dataclass
+class JSONRPCResponse:
+    """A JSON-RPC 2.0 response."""
+
+    id: int
+    jsonrpc: str = "2.0"
+    result: Any = None
+    error: JSONRPCError | None = None
+
+    @property
+    def is_error(self) -> bool:
+        """Check if this response contains an error."""
+        return self.error is not None
+
+
+@dataclass
+class ToolDefinition:
+    """An MCP tool definition as returned by tools/list."""
+
+    name: str
+    description: str = ""
+    inputSchema: dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class MCPServerCapabilities:
+    """Server capabilities reported during initialization."""
+
+    tools: dict[str, Any] | None = None
+    resources: dict[str, Any] | None = None
+    prompts: dict[str, Any] | None = None
+    logging: dict[str, Any] | None = None
+    experimental: dict[str, Any] | None = None
+
+
+@dataclass
+class ServerInfo:
+    """Server information returned by the initialize response."""
+
+    name: str
+    version: str
+    protocol_version: str = ""
+    capabilities: MCPServerCapabilities = field(default_factory=MCPServerCapabilities)
+    instructions: str | None = None
+
+
+@dataclass
+class CallToolResult:
+    """Structured result of a tools/call invocation.
+
+    When ``isError`` is True, the tool execution failed and ``content``
+    contains an error message.  Otherwise ``content`` holds the
+    structured output and ``structured_content`` may carry a typed
+    payload the server attached.
+    """
+
+    content: Any
+    isError: bool = False
+    structured_content: Any = None

dataify_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: dataify-sdk
+Version: 0.1.0
+Summary: Python SDK for the Dataify MCP API — access web unlocker, search engines, and platform scrapers.
+Project-URL: Homepage, https://dashboard.dataify.com
+Project-URL: Repository, https://github.com/dataify/dataify-mcp-sdk
+Author-email: Dataify <support@dataify.com>
+License: MIT
+License-File: LICENSE
+Keywords: dataify,google-search,mcp,scraper,serp,web-unlocker
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: jinja2>=3.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Dataify MCP Python SDK
+
+Python 客户端库，用于通过 [MCP (Model Context Protocol)](https://spec.modelcontextprotocol.io/) 访问 [Dataify](https://dashboard.dataify.com) 数据采集平台。
+
+## 功能
+
+- 🌐 **网页解锁器** — 绕过 CAPTCHA、JS 渲染，返回 HTML 或 PNG 截图
+- 🔍 **搜索引擎** — Google（17 种搜索类型）、Bing（6 种）、Yandex、DuckDuckGo
+- 🛒 **平台抓取器** — Amazon、YouTube、TikTok、Facebook、Instagram、Reddit、Twitter/X、LinkedIn、Glassdoor、Indeed 等 35+ 平台
+- ⚡ **异步优先** — 基于 `httpx` 的现代异步 API
+- 🛡️ **类型安全** — 完整的类型注解，支持 `mypy --strict`
+- 🔌 **双传输模式** — 支持 Streamable HTTP 和 SSE
+
+## 安装
+
+```bash
+pip install dataify-mcp
+```
+
+要求 Python >= 3.10。
+
+## 快速开始
+
+```python
+import asyncio
+from dataify_mcp import DataifyClient
+
+async def main():
+    async with DataifyClient(
+        base_url="http://localhost:7780",
+        token="your-api-token",
+    ) as client:
+        # 列出可用工具
+        tools = await client.list_tools()
+        print(f"可用工具: {len(tools)} 个")
+
+        # 调用 Google 搜索
+        result = await client.call_tool("google_search", {
+            "q": "今天天气",
+            "gl": "cn",
+            "hl": "zh-cn",
+        })
+        print(result)
+
+asyncio.run(main())
+```
+
+## 连接方式
+
+### Streamable HTTP（默认）
+
+```python
+client = DataifyClient(
+    base_url="http://localhost:7780",
+    token="your-token",
+    transport="http",  # 默认值
+)
+```
+
+### SSE（Server-Sent Events）
+
+```python
+client = DataifyClient(
+    base_url="http://localhost:7780",
+    token="your-token",
+    transport="sse",
+)
+```
+
+### 工具权限过滤
+
+```python
+# 只使用指定的工具类别
+client = DataifyClient(
+    base_url="http://localhost:7780",
+    token="your-token",
+    tool_codes="serp,google",  # 多个用逗号分隔
+)
+```
+
+## 错误处理
+
+```python
+from dataify_mcp import (
+    DataifyClient,
+    AuthenticationError,
+    ToolError,
+    ConnectionError,
+)
+
+try:
+    async with DataifyClient("http://localhost:7780", "token") as client:
+        result = await client.call_tool("google_search", {"q": "test"})
+except AuthenticationError:
+    print("Token 无效，请检查 https://dashboard.dataify.com")
+except ToolError as e:
+    print(f"工具执行失败: {e}")
+except ConnectionError:
+    print("无法连接服务器")
+```
+
+## 开发
+
+```bash
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 代码检查
+ruff check src/dataify_mcp/
+mypy src/dataify_mcp/
+
+# 运行测试
+pytest
+
+# 生成工具封装代码
+python scripts/codegen.py --server http://localhost:7780 --token YOUR_TOKEN
+```
+
+## 许可
+
+MIT License

dataify_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,34 @@
+dataify_mcp/__init__.py,sha256=3eXDv3uoyZPvPJWbyubt-z_81Qm6xjNTplB4tlZnDY0,934
+dataify_mcp/_version.py,sha256=-UYTpK8lRuzcw9BEWkdBHyJiS_vjvg0P06Wo2xs--us,77
+dataify_mcp/client/__init__.py,sha256=78M0JRVe0v3_SjXhzHo9vY0AVru9gp8TA5LpWtcLmIc,266
+dataify_mcp/client/_base.py,sha256=UJBm89PDAjkPt-9SWoh3xnwNceF6Pi3fJgdk3zyfiP4,7376
+dataify_mcp/client/_http.py,sha256=aWV-fX2fJXYpa_XIEg7nwqavs8sjb2K3osNC2vCEinI,6724
+dataify_mcp/client/_protocol.py,sha256=_Iz6DIG9MismSCidBCEYjx9ZlvxFtUaQXY41A0AnzYU,7313
+dataify_mcp/client/_sse.py,sha256=52Spk2bZgKqn0WbLc3cRg4NpyQx65tuZR4S4lTPnDG0,11608
+dataify_mcp/tools/__init__.py,sha256=3bV0IQUbQuiu8pwhZnFlTBVWgfgEq4gJVc8XjAp1Oz0,2551
+dataify_mcp/tools/amazon.py,sha256=lxqRAsAKuea9PWkWqwo5TUOinuzuFW9mXC3sfkw_-q4,6317
+dataify_mcp/tools/bing.py,sha256=4xmSlSAZGH7PZL5u2jxhv7FpogKD0gmJHEWMVUvhCMs,5598
+dataify_mcp/tools/facebook.py,sha256=TsuvAXTcHE88zi-abVr2HWLZ0EU27KzZS6vHvyn0uDA,2381
+dataify_mcp/tools/glassdoor.py,sha256=mFRj6NOoyMtrNB0mtW30z9ctz-L-7yEr5ILCRFwVOAE,1493
+dataify_mcp/tools/google_scraper.py,sha256=D9Y-s1E19G61MLtQfw-BNPcqc-8tpsPVAxv-O2k7G3g,5188
+dataify_mcp/tools/google_serp.py,sha256=lnpL9oUXM_rXw3GTINFEb7q_IfMOwE_klG3u_YiWiCA,14205
+dataify_mcp/tools/indeed.py,sha256=vzPJBtS17gTd7BoOIRQzHcqq7jA3lRdB-imA-06gTpo,1478
+dataify_mcp/tools/instagram.py,sha256=NL_jRHKBv-urD73eantYGxlXYOnVyqqd2VHvDh4PyQw,1918
+dataify_mcp/tools/linkedin.py,sha256=gbz56x3z0FjFzILTdpHoCqYdAHC3mmiqiRJ58uR0O_I,1674
+dataify_mcp/tools/other_scrapers.py,sha256=kU3s66jZBYSEzyRUh9l4CLcNS_4kuf9BTknBEDBVyMU,5479
+dataify_mcp/tools/other_search.py,sha256=mSw_dSu0JQm7Urj0Lgehl9lLSVvTIauSCOWyMyG0Fkk,3971
+dataify_mcp/tools/reddit.py,sha256=GuZC_H08n_LqFwR5l8EpfXiQn8PTxB9Pnpm1mQ7Gba4,1356
+dataify_mcp/tools/task_status.py,sha256=n-PgGAQA5ketTrES5kRj17xOgACBgB_F9BKCikDKV0E,7859
+dataify_mcp/tools/tiktok.py,sha256=ftqq6p-XR1RHvB6llW3K_r71R4As4avgo9eMm9ieSwQ,3181
+dataify_mcp/tools/twitter.py,sha256=7uv1zRr6adj3YvpREuBjiwrloAIvMzAEsgAKBRM5vg4,1385
+dataify_mcp/tools/user.py,sha256=A4oQ3kLOEZcWydP8Oc9FHvrQjzqVr-YFn0GWOeTQIWQ,2644
+dataify_mcp/tools/web_unlocker.py,sha256=Gj1YshmE7YmvLwzv7ymtQd5KyqyBnIYD4IWeqP63-lw,2573
+dataify_mcp/tools/youtube.py,sha256=GZZNVMooeNnck4YKy9ErQcBY-xn1OKrm3WDaqUY4V0s,6832
+dataify_mcp/types/__init__.py,sha256=OGKjtSU4Wa6sldFeZkOaGG-bkKcNWjusle07BHA5OuU,754
+dataify_mcp/types/_enums.py,sha256=a5e1FE022nFOTDlsimoBt-pEEgGzrRPVRUaOmZ0le7c,4756
+dataify_mcp/types/_errors.py,sha256=TGLQKAvd02OjsZoOhRjzadFZj8JY3w8XbIIwJ1MTV_s,2325
+dataify_mcp/types/_mcp.py,sha256=XTftEL8BybdmOy9V3VogYuvm1me0-AmhBPK3-zSnuO0,2034
+dataify_sdk-0.1.0.dist-info/METADATA,sha256=2QhYtXyQMsZIsHhoK2HuF9wQp5gB8x5FhKffc1tl2yQ,4148
+dataify_sdk-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+dataify_sdk-0.1.0.dist-info/licenses/LICENSE,sha256=cil50Gh9EoDkZb-MQGFr1K8j82sbM5iHqCSxwkjmgag,1071
+dataify_sdk-0.1.0.dist-info/RECORD,,

dataify_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

dataify_sdk-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dataify-server
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.