Skip to main content

Official Python clients for all 165 mcpscraper.dev MCP tools and the direct memory API

Project description

mcpscraper-memory-sdk (Python)

Official Python clients for all 165 unified mcpscraper.dev MCP tools plus the direct 89-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 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:

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 89 tools via a scraper key) · mcpscraper-cli

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcpscraper_memory_sdk-0.13.1.tar.gz (110.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcpscraper_memory_sdk-0.13.1-py3-none-any.whl (202.9 kB view details)

Uploaded Python 3

File details

Details for the file mcpscraper_memory_sdk-0.13.1.tar.gz.

File metadata

  • Download URL: mcpscraper_memory_sdk-0.13.1.tar.gz
  • Upload date:
  • Size: 110.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for mcpscraper_memory_sdk-0.13.1.tar.gz
Algorithm Hash digest
SHA256 0c0c4fa5bcb07a563951f7710920f9ebeda97d742c5c4caf135b07c9f591cede
MD5 f34d502f06093cc46b1564634d6bcc56
BLAKE2b-256 5982e79124c32710b0a434f83ec8f561fd3fa3982da3b80081c473fa62545bd6

See more details on using hashes here.

File details

Details for the file mcpscraper_memory_sdk-0.13.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mcpscraper_memory_sdk-0.13.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0b1fd9113a57be250d4b39448b439f9b24e4ece5a7a2405bb3510e7f95f97737
MD5 1ed86fc4bbfbfb388e317fbc08483892
BLAKE2b-256 ff724987e910704020aad5c556c58dbdda63411ec5838698679e788f6749d700

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page