Skip to main content

mcpscraper-memory-sdk (Python)

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

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 373 unified tools, including governed X-Ray revenue, survey, attribution-impact, and 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.34.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.34.0
File Size Uploaded
mcpscraper_memory_sdk-0.34.0.tar.gz 189.0 kB Details

Built distribution (wheel)

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

Total release size: 742.3 kB

Release files / mcpscraper_memory_sdk-0.34.0.tar.gz

Download URL mcpscraper_memory_sdk-0.34.0.tar.gz
Size 189.0 kB
Tags Source
SHA-256 checksum
How to use checksums
684dd21525df55045e538eb1ab0fefb51c151ce7184b665769e92db383ea4bff
BLAKE2b-256 checksum
How to use checksums
44b9970d6cfdf3ebac9fe2adc15585d24b0f4ab48f0bc03cc5e5764590f98248
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.34.0-py3-none-any.whl

Download URL mcpscraper_memory_sdk-0.34.0-py3-none-any.whl
Size 553.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f5c9f3384054a78d1fcdd11d3537d52d0b54fb8d18645e5b10a2d12e18b7e17b
BLAKE2b-256 checksum
How to use checksums
528f0815d7973fde445b1a1b9b8c61afbc73e6a7f0e205a1e873cbb714807d8a
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