Skip to main content

mcpscraper-memory-sdk (Python)

Official Python clients for all 246 unified mcpscraper.dev MCP tools plus the direct 114-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.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 246 unified tools (145 MCP Scraper plus 101 mirrored Memory tools); 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 114 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 114 tools via a scraper key) · mcpscraper-cli

Release files for mcpscraper-memory-sdk 0.25.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.25.0
File Size Uploaded
mcpscraper_memory_sdk-0.25.0.tar.gz 150.6 kB Details

Built distribution (wheel)

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

Total release size: 456.7 kB

Release files / mcpscraper_memory_sdk-0.25.0.tar.gz

Download URL mcpscraper_memory_sdk-0.25.0.tar.gz
Size 150.6 kB
Tags Source
SHA-256 checksum
How to use checksums
d6e6562411a1f7749fb77949955cf4be69f6e557b119f1da3a0d7fb555eb2c50
BLAKE2b-256 checksum
How to use checksums
c17c4718c1a62475539ba2f71029ec591d9352308b59f1195b14653e12c1fe41
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.25.0-py3-none-any.whl

Download URL mcpscraper_memory_sdk-0.25.0-py3-none-any.whl
Size 306.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c64b420a9b41f72bcc75e84e16e7f2060d50dee0e984d0a36403f7d17849ee56
BLAKE2b-256 checksum
How to use checksums
477c4550423e0ca5c7a1fabdd6857629a7712c118a5104da679d5e12671ad916
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