mcpscraper-memory-sdk 0.13.0__tar.gz

mcpscraper_memory_sdk-0.13.0/.gitignore

@@ -0,0 +1,12 @@
+node_modules/
+dist/
+*.log
+.env
+.env.*
+!.env.example
+.DS_Store
+.venv/
+__pycache__/
+*.pyc
+*.egg-info/
+.pytest_cache/

mcpscraper_memory_sdk-0.13.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: mcpscraper-memory-sdk
+Version: 0.13.0
+Summary: Official Python clients for all 165 mcpscraper.dev MCP tools and the direct memory API
+Project-URL: Repository, https://github.com/VilovietaSEO/mcpscraper-sdk
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2
+Requires-Dist: requests>=2.31
+Description-Content-Type: text/markdown
+
+# mcpscraper-memory-sdk (Python)
+
+Official Python clients for all 165 unified [mcpscraper.dev](https://mcpscraper.dev) MCP tools plus the direct 89-tool [memory.mcpscraper.dev](https://memory.mcpscraper.dev) API.
+
+This is a thin JSON-RPC client generated against [`../../contracts/memory.tools.json`](../../contracts/memory.tools.json), the public contract for the hosted API. It contains no product source — only typed request/response plumbing.
+
+## Install
+
+```bash
+pip install "mcpscraper-memory-sdk @ git+https://github.com/VilovietaSEO/mcpscraper-sdk.git#subdirectory=packages/memory-python"
+```
+
+## Usage
+
+```python
+from mcpscraper_memory import MemoryClient, MemoryApiError
+
+client = MemoryClient(api_key="mk_your_key")
+
+try:
+    result = client.memory.search(query="competitor pricing pages")
+    for hit in result.results or []:
+        print(hit["source"], hit["score"])
+except MemoryApiError as err:
+    print(f"memory call failed: {err}")
+```
+
+## Namespaces
+
+`client.access`, `client.capture`, `client.channels`, `client.facts`, `client.library`, `client.memory`, `client.recall`, `client.schedule`, `client.storage`, `client.tables`, `client.vaults`, `client.video`, `client.webhooks` — one method per tool, snake_case, typed with generated Pydantic models.
+
+Use `McpToolsClient(api_key="sk_...")` for all 165 unified tools (76 MCP Scraper plus 89 mirrored memory tools); it has the same generated namespaces as every other SDK package. Bulk Gmail, Calendar, Zoom, Meta Marketing, and Resend exports are available through `client.connections.export_connected_service_data(...)`; select `meta_ads_insights` for daily account/campaign/ad-set/ad reporting or `resend_data` for the Resend aggregate, and renew expired artifact URLs with `client.connections.renew_connected_data_download(artifact_id="artifact_123")`.
+
+Use `client.call_tool_result(name, args)` for native MCP image, audio, or resource blocks. The existing `call_tool` method keeps returning the parsed structured/text value.
+
+## Don't have a memory key?
+
+If you already have an `mcpscraper.dev` API key and don't want to provision a separate `mk_...` memory key, use `mcpscraper-sdk`'s `ScraperClient.memory_tools` instead — it exposes this exact same set of 89 tools, dispatched through your scraper API key.
+
+## Regenerating models
+
+`src/mcpscraper_memory/models/` and `_generated_client.py` are generated from `../../contracts/memory.tools.json`. After editing the manifest, regenerate with:
+
+```bash
+python scripts/generate_models.py
+```
+
+## See also
+
+[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk` on npm](../memory) (Node) · [`mcpscraper-sdk` Python source package](../scraper-python) (also reaches these 89 tools via a scraper key) · [`mcpscraper-cli`](../cli)

mcpscraper_memory_sdk-0.13.0/README.md

@@ -0,0 +1,50 @@
+# mcpscraper-memory-sdk (Python)
+
+Official Python clients for all 165 unified [mcpscraper.dev](https://mcpscraper.dev) MCP tools plus the direct 89-tool [memory.mcpscraper.dev](https://memory.mcpscraper.dev) API.
+
+This is a thin JSON-RPC client generated against [`../../contracts/memory.tools.json`](../../contracts/memory.tools.json), the public contract for the hosted API. It contains no product source — only typed request/response plumbing.
+
+## Install
+
+```bash
+pip install "mcpscraper-memory-sdk @ git+https://github.com/VilovietaSEO/mcpscraper-sdk.git#subdirectory=packages/memory-python"
+```
+
+## Usage
+
+```python
+from mcpscraper_memory import MemoryClient, MemoryApiError
+
+client = MemoryClient(api_key="mk_your_key")
+
+try:
+    result = client.memory.search(query="competitor pricing pages")
+    for hit in result.results or []:
+        print(hit["source"], hit["score"])
+except MemoryApiError as err:
+    print(f"memory call failed: {err}")
+```
+
+## Namespaces
+
+`client.access`, `client.capture`, `client.channels`, `client.facts`, `client.library`, `client.memory`, `client.recall`, `client.schedule`, `client.storage`, `client.tables`, `client.vaults`, `client.video`, `client.webhooks` — one method per tool, snake_case, typed with generated Pydantic models.
+
+Use `McpToolsClient(api_key="sk_...")` for all 165 unified tools (76 MCP Scraper plus 89 mirrored memory tools); it has the same generated namespaces as every other SDK package. Bulk Gmail, Calendar, Zoom, Meta Marketing, and Resend exports are available through `client.connections.export_connected_service_data(...)`; select `meta_ads_insights` for daily account/campaign/ad-set/ad reporting or `resend_data` for the Resend aggregate, and renew expired artifact URLs with `client.connections.renew_connected_data_download(artifact_id="artifact_123")`.
+
+Use `client.call_tool_result(name, args)` for native MCP image, audio, or resource blocks. The existing `call_tool` method keeps returning the parsed structured/text value.
+
+## Don't have a memory key?
+
+If you already have an `mcpscraper.dev` API key and don't want to provision a separate `mk_...` memory key, use `mcpscraper-sdk`'s `ScraperClient.memory_tools` instead — it exposes this exact same set of 89 tools, dispatched through your scraper API key.
+
+## Regenerating models
+
+`src/mcpscraper_memory/models/` and `_generated_client.py` are generated from `../../contracts/memory.tools.json`. After editing the manifest, regenerate with:
+
+```bash
+python scripts/generate_models.py
+```
+
+## See also
+
+[Repo README](../../README.md) (multi-language examples with real sample output) · [`mcpscraper-memory-sdk` on npm](../memory) (Node) · [`mcpscraper-sdk` Python source package](../scraper-python) (also reaches these 89 tools via a scraper key) · [`mcpscraper-cli`](../cli)

mcpscraper_memory_sdk-0.13.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "mcpscraper-memory-sdk"
+version = "0.13.0"
+description = "Official Python clients for all 165 mcpscraper.dev MCP tools and the direct memory API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = [
+    "requests>=2.31",
+    "pydantic>=2",
+]
+
+[project.urls]
+Repository = "https://github.com/VilovietaSEO/mcpscraper-sdk"
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "responses>=0.25",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcpscraper_memory"]

mcpscraper_memory_sdk-0.13.0/scripts/generate_models.py

@@ -0,0 +1,154 @@
+import json
+import keyword
+import re
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[3]
+MANIFEST_PATH = REPO_ROOT / "contracts" / "memory.tools.json"
+PACKAGE_ROOT = Path(__file__).resolve().parents[1]
+MODELS_DIR = PACKAGE_ROOT / "src" / "mcpscraper_memory" / "models"
+CLIENT_GENERATED_PATH = PACKAGE_ROOT / "src" / "mcpscraper_memory" / "_generated_client.py"
+
+CATEGORIES = [
+    "access", "capture", "channels", "facts", "graph", "library", "memory", "recall",
+    "schedule", "storage", "tables", "tags", "vaults", "video", "webhooks",
+]
+
+
+def to_snake_case(value: str) -> str:
+    value = re.sub(r"[-\s]+", "_", value)
+    value = re.sub(r"(?<!^)(?=[A-Z])", "_", value)
+    snake = value.lower().strip("_")
+    return f"{snake}_" if keyword.iskeyword(snake) else snake
+
+
+def derive_method_name(legacy_id: str, category: str) -> str:
+    for candidate in (category, category.rstrip("s")):
+        prefix = f"{candidate}-"
+        if legacy_id.startswith(prefix) and len(legacy_id) > len(prefix):
+            return to_snake_case(legacy_id[len(prefix):])
+    return to_snake_case(legacy_id)
+
+
+def to_pascal_case(value: str) -> str:
+    parts = re.split(r"[-_\s]+", value)
+    return "".join(p[0].upper() + p[1:] for p in parts if p)
+
+
+def json_type_to_python(schema: dict, class_name_hint: str) -> str:
+    if "enum" in schema:
+        literal_values = ", ".join(json.dumps(v) for v in schema["enum"])
+        return f"Literal[{literal_values}]"
+    json_type = schema.get("type")
+    if json_type == "string":
+        return "str"
+    if json_type == "integer":
+        return "int"
+    if json_type == "number":
+        return "float"
+    if json_type == "boolean":
+        return "bool"
+    if json_type == "array":
+        item_schema = schema.get("items", {})
+        item_type = json_type_to_python(item_schema, class_name_hint)
+        return f"list[{item_type}]"
+    if json_type == "object" or "properties" in schema:
+        return "dict[str, Any]"
+    return "Any"
+
+
+def field_definition(name: str, schema: dict, required: bool, class_name_hint: str) -> str:
+    py_type = json_type_to_python(schema, class_name_hint)
+    if not required:
+        py_type = f"{py_type} | None"
+    description = schema.get("description", "").replace('"', '\\"')
+    default = "None" if not required else "..."
+    return f'    {to_snake_case(name)}: {py_type} = Field({default}, alias="{name}", description="{description}")'
+
+
+def render_model(class_name: str, schema: dict) -> str:
+    properties = schema.get("properties", {}) or {}
+    required = set(schema.get("required", []) or [])
+    if not properties:
+        return f"class {class_name}(BaseModel):\n    model_config = ConfigDict(populate_by_name=True, extra=\"allow\")\n"
+    lines = [f"class {class_name}(BaseModel):", '    model_config = ConfigDict(populate_by_name=True, extra="allow")', ""]
+    for prop_name, prop_schema in properties.items():
+        lines.append(field_definition(prop_name, prop_schema, prop_name in required, class_name))
+    return "\n".join(lines) + "\n"
+
+
+def main() -> None:
+    manifest = json.loads(MANIFEST_PATH.read_text())
+    tools = manifest["tools"]
+
+    MODELS_DIR.mkdir(parents=True, exist_ok=True)
+    (MODELS_DIR / "__init__.py").write_text("")
+
+    by_category: dict[str, list[dict]] = {}
+    for tool in tools:
+        by_category.setdefault(tool["category"], []).append(tool)
+
+    for tool in tools:
+        legacy = tool["legacyId"]
+        module_name = to_snake_case(legacy)
+        input_class = to_pascal_case(legacy) + "Input"
+        output_class = to_pascal_case(legacy) + "Output"
+
+        content = [
+            "from typing import Any, Literal",
+            "from pydantic import BaseModel, ConfigDict, Field",
+            "",
+            "",
+            render_model(input_class, tool["inputSchema"]),
+            "",
+            render_model(output_class, tool["outputSchema"]),
+        ]
+        (MODELS_DIR / f"{module_name}.py").write_text("\n".join(content))
+
+    namespace_blocks = []
+    import_lines = []
+    for category in CATEGORIES:
+        class_name = to_pascal_case(category) + "Namespace"
+        method_blocks = []
+        used_names: set[str] = set()
+        for tool in by_category.get(category, []):
+            legacy = tool["legacyId"]
+            wire_name = tool["name"]
+            module_name = to_snake_case(legacy)
+            input_class = to_pascal_case(legacy) + "Input"
+            output_class = to_pascal_case(legacy) + "Output"
+            method_name = derive_method_name(legacy, category)
+            if method_name in used_names:
+                method_name = to_snake_case(legacy)
+            used_names.add(method_name)
+
+            import_lines.append(
+                f"from .models.{module_name} import {input_class}, {output_class}"
+            )
+            method_blocks.append(
+                f'    def {method_name}(self, **kwargs: Any) -> {output_class}:\n'
+                f'        payload = {input_class}(**kwargs).model_dump(by_alias=True, exclude_none=True)\n'
+                f'        result = self._call_tool("{wire_name}", payload)\n'
+                f'        return {output_class}.model_validate(result)\n'
+            )
+        namespace_blocks.append(
+            f"class {class_name}:\n"
+            f"    def __init__(self, call_tool):\n"
+            f"        self._call_tool = call_tool\n\n"
+            + "\n".join(method_blocks)
+        )
+
+    generated = (
+        "from typing import Any, Callable\n\n"
+        + "\n".join(sorted(set(import_lines)))
+        + "\n\n\n"
+        + "\n\n".join(namespace_blocks)
+        + "\n"
+    )
+    CLIENT_GENERATED_PATH.write_text(generated)
+
+    print(f"Generated {len(tools)} tool model pairs across {len(by_category)} categories.")
+
+
+if __name__ == "__main__":
+    main()

mcpscraper_memory_sdk-0.13.0/src/mcpscraper_memory/__init__.py

@@ -0,0 +1,9 @@
+from .client import MemoryClient
+from .errors import MemoryApiError
+from .mcp_client import McpToolsClient, McpToolError
+from ._mcp_generated_client import MCP_TOOL_BINDINGS, MCP_TOOL_COUNT
+
+__all__ = [
+    "MemoryClient", "MemoryApiError", "McpToolsClient", "McpToolError",
+    "MCP_TOOL_BINDINGS", "MCP_TOOL_COUNT",
+]