Skip to main content

mcpscraper-memory-sdk (Python)

Official Python clients for all 369 unified mcpscraper.dev MCP tools plus the direct 121-tool memory.mcpscraper.dev API.

Release history

This is a thin JSON-RPC client generated against ../../contracts/memory.tools.json, the public contract for the hosted API. It contains no product source — only typed request/response plumbing.

Install

pip install mcpscraper-memory-sdk

Usage

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.files, client.graph, client.library, client.memory, client.recall, client.schedule, client.storage, client.tables, client.tags, client.vaults, client.video, client.webhooks — one method per tool, snake_case, typed with generated Pydantic models. Original Gmail attachment bytes saved to Memory are available through client.files.file_asset_save(...) and client.files.file_asset_get(...).

Use McpToolsClient(api_key="sk_...") for all 369 unified tools, including provider-neutral X-Ray surveys, attribution-impact reporting, and truthful evidence-status operations; it has the same generated namespaces as every other SDK package. The ZIP reader is available as client.web.archive_read(url=...), and the editorial workflow begins with client.editorial.reading_room_guide(focus="workflow"). Scheduled results and saved artifact templates are available under client.schedule; run IDs and cursors remain opaque. 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 121 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:

python scripts/generate_models.py

See also

Repo README (multi-language examples with real sample output) · mcpscraper-memory-sdk on npm (Node) · mcpscraper-sdk on PyPI (also reaches these 121 tools via a scraper key) · mcpscraper-cli

Release files for mcpscraper-memory-sdk 0.35.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcpscraper-memory-sdk 0.35.0
File Size Uploaded
mcpscraper_memory_sdk-0.35.0.tar.gz 188.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcpscraper-memory-sdk 0.35.0
File Interpreter ABI Platform
mcpscraper_memory_sdk-0.35.0-py3-none-any.whl Python 3 none any Details

Total release size: 738.1 kB

Release files / mcpscraper_memory_sdk-0.35.0.tar.gz

Download URL mcpscraper_memory_sdk-0.35.0.tar.gz
Size 188.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b4b24305cd50a8adc7378bcf567baa8dcac982c111bde2cbc933ac905b17d650
BLAKE2b-256 checksum
How to use checksums
7640df895214b9b6999162e30454c39887e28905cf46a49ebf203a080c8597dd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / mcpscraper_memory_sdk-0.35.0-py3-none-any.whl

Download URL mcpscraper_memory_sdk-0.35.0-py3-none-any.whl
Size 550.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
deadd5212f0b92cda36449f3a3af225180ca7867fd2b8211c2707b3327a73875
BLAKE2b-256 checksum
How to use checksums
9dbd94311044c897f6864b6ef2374c59e6148f0167c957e74f12f9a2ce9dad29
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page