mcpscraper-memory-sdk 0.13.0__py3-none-any.whl

mcpscraper_memory/mcp_models/audit_site.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class AuditSiteInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    url: str = Field(..., alias="url", description="Public website URL or domain for a full technical SEO audit (issues, link graph, indexability, headings, images). For plain content use extract_site instead.")
+    max_pages: int | None = Field(None, alias="maxPages", description="Maximum pages to crawl and audit. Always writes a folder of analysis files plus per-page content, returning a summary plus the folder path.")
+    rotate_proxies: bool | None = Field(None, alias="rotateProxies", description="Route page fetches through rotating residential proxies to defeat rate-limiting and bot blocks. Slower/pricier — use only when a site blocks normal crawling.")
+    rotate_proxy_every: int | None = Field(None, alias="rotateProxyEvery", description="When rotateProxies is on, pages fetched per proxy before rotating. Default 30.")
+    background: bool | None = Field(None, alias="background", description="Run the audit as a background job instead of blocking this call, returning a jobId immediately — poll it with check_site_export to get a downloadable zip (full audit report, all page content, plus real image files if downloadImages is set) once ready. Use for large sites where a synchronous call would be slow.")
+    download_images: bool | None = Field(None, alias="downloadImages", description="Download every discovered image as a real file into the export bundle (not just image URLs/stats). OFF by default — must be explicitly set true. Implies background regardless of the background flag, since downloading a whole site's images is too slow to run synchronously. Capped at 20 images/page and 500 images/site.")
+
+
+class AuditSiteOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_click.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserClickInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+    x: float = Field(..., alias="x", description="X coordinate to click, in screenshot pixels. Use only coordinates from the latest browser_screenshot, browser_read, or browser_locate result; do not guess.")
+    y: float = Field(..., alias="y", description="Y coordinate to click, in screenshot pixels. Use only coordinates from the latest browser_screenshot, browser_read, or browser_locate result; do not guess.")
+    button: Literal["left", "right", "middle"] | None = Field(None, alias="button", description="Mouse button.")
+    num_clicks: int | None = Field(None, alias="num_clicks", description="Number of clicks, e.g. 2 for double-click.")
+
+
+class BrowserClickOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_close.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserCloseInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+
+
+class BrowserCloseOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_extension_delete.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserExtensionDeleteInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    name: str = Field(..., alias="name", description="Name of the extension to remove, as returned by browser_extension_list.")
+
+
+class BrowserExtensionDeleteOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_extension_import.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserExtensionImportInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    store_url: str = Field(..., alias="store_url", description="Chrome Web Store URL of the extension to add, e.g. https://chromewebstore.google.com/detail/<slug>/<id>.")
+    name: str = Field(..., alias="name", description="Short name to save this extension under, e.g. \"ani-ai\". Reuse it later in extension_names on browser_open.")
+
+
+class BrowserExtensionImportOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_extension_list.py

@@ -0,0 +1,10 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserExtensionListInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class BrowserExtensionListOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_goto.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserGotoInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+    url: str = Field(..., alias="url", description="URL to navigate the browser to.")
+
+
+class BrowserGotoOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_list_replays.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserListReplaysInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+
+
+class BrowserListReplaysOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_list_sessions.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserListSessionsInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    include_closed: bool | None = Field(None, alias="include_closed", description="Include closed sessions in the list.")
+
+
+class BrowserListSessionsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_locate.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserLocateInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+    targets: list[dict[str, Any]] = Field(..., alias="targets", description="DOM targets to locate in the current viewport. Use selectors for exact elements, or text for visible text ranges.")
+
+
+class BrowserLocateOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_open.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserOpenInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    label: str | None = Field(None, alias="label", description="Optional human label for this session, shown in the watch console.")
+    url: str | None = Field(None, alias="url", description="Optional URL to navigate to immediately after opening.")
+    profile: str | None = Field(None, alias="profile", description="Optional saved hosted profile name to load a logged-in session for a site.")
+    save_profile_changes: bool | None = Field(None, alias="save_profile_changes", description="Persist cookies/storage back to the named profile on close. Avoid parallel sessions writing to the same profile.")
+    timeout_seconds: int | None = Field(None, alias="timeout_seconds", description="Session lifetime before auto-termination. Defaults to 600.")
+    extension_names: list[str] | None = Field(None, alias="extension_names", description="Names of extensions previously added with browser_extension_import (see browser_extension_list for what's available) to load into this session. Loading extensions restarts the browser, adding a few seconds to startup.")
+
+
+class BrowserOpenOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_press.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserPressInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+    keys: list[str] = Field(..., alias="keys", description="Keys or combinations to press, e.g. [\"Return\"], [\"Ctrl+a\"], [\"Ctrl+Shift+Tab\"].")
+
+
+class BrowserPressOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_profile_connect.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserProfileConnectInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    email: str | None = Field(None, alias="email", description="Account email for the login. Derives a stable profile name and is recorded as a note. Does NOT import existing cookies — the user signs in fresh.")
+    profile: str | None = Field(None, alias="profile", description="Profile to add this login to. Omit to derive from email. A single profile holds MANY logins — pass the same name with a different domain to stack accounts.")
+    domain: str | None = Field(None, alias="domain", description="Site to log into, e.g. chatgpt.com, claude.ai, reddit.com. Defaults to chatgpt.com.")
+    login_url: str | None = Field(None, alias="login_url", description="Login page for the domain. Defaults to https://<domain>/.")
+    url: str | None = Field(None, alias="url", description="Deprecated alias for login_url.")
+    note: str | None = Field(None, alias="note", description="Free-text note describing this login. Surfaced by browser_profile_list.")
+    label: str | None = Field(None, alias="label", description="Optional human label for this sign-in setup session.")
+    timeout_seconds: int | None = Field(None, alias="timeout_seconds", description="Sign-in session lifetime before auto-termination. Defaults to 600.")
+
+
+class BrowserProfileConnectOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_profile_list.py

@@ -0,0 +1,15 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserProfileListInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    profile: str | None = Field(None, alias="profile", description="Profile whose saved logins to list. Omit to derive from email.")
+    email: str | None = Field(None, alias="email", description="Account email used to derive the profile name when profile is not given.")
+    domain: str | None = Field(None, alias="domain", description="Restrict to one site login, e.g. chatgpt.com. Use this to poll a single login until its status reads AUTHENTICATED.")
+    connection_id: str | None = Field(None, alias="connection_id", description="A specific login connection id returned by browser_profile_connect, to poll just that one.")
+
+
+class BrowserProfileListOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_read.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserReadInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+
+
+class BrowserReadOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_replay_annotate.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserReplayAnnotateInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+    replay_id: str = Field(..., alias="replay_id", description="The replay id returned by browser_replay_start or browser_list_replays.")
+    annotations: list[dict[str, Any]] = Field(..., alias="annotations", description="Timed overlay annotations. Prefer ones from browser_replay_mark; otherwise use exact DOM bounds from browser_locate.")
+    filename: str | None = Field(None, alias="filename", description="Optional output MP4 filename. Defaults to a timestamped filename.")
+    source_width: float | None = Field(None, alias="source_width", description="Width of the screenshot coordinate space used for annotations. Defaults to the replay video width.")
+    source_height: float | None = Field(None, alias="source_height", description="Height of the annotation coordinate space; if smaller than the replay video height, the browser chrome offset is inferred.")
+    source_left_offset: float | None = Field(None, alias="source_left_offset", description="Explicit X offset from annotation to replay video coordinates. Usually omitted.")
+    source_top_offset: float | None = Field(None, alias="source_top_offset", description="Explicit Y offset from annotation to replay video coordinates. Usually omitted.")
+
+
+class BrowserReplayAnnotateOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_replay_download.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserReplayDownloadInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+    replay_id: str = Field(..., alias="replay_id", description="The replay id returned by browser_replay_start or browser_list_replays.")
+    filename: str | None = Field(None, alias="filename", description="Optional local MP4 filename. Defaults to a timestamped replay filename.")
+
+
+class BrowserReplayDownloadOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_replay_mark.py

@@ -0,0 +1,20 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserReplayMarkInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions. A replay must already be recording.")
+    target: dict[str, Any] = Field(..., alias="target", description="The exact DOM element or text range to mark in the current viewport.")
+    type: Literal["box", "circle", "underline", "arrow"] | None = Field(None, alias="type", description="Annotation style to generate.")
+    label: str | None = Field(None, alias="label", description="Optional callout text to render near the target.")
+    color: str | None = Field(None, alias="color", description="Annotation color as hex, e.g. #ff3b30.")
+    thickness: float | None = Field(None, alias="thickness", description="Stroke thickness in pixels. Defaults to 5.")
+    padding: float | None = Field(None, alias="padding", description="Pixels to expand the DOM bounds so the highlight does not touch the text edge.")
+    start_offset_seconds: float | None = Field(None, alias="start_offset_seconds", description="Offset from the current replay time; negative appears just before the mark action.")
+    duration_seconds: float | None = Field(None, alias="duration_seconds", description="How long the annotation should remain visible.")
+
+
+class BrowserReplayMarkOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_replay_start.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserReplayStartInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+
+
+class BrowserReplayStartOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_replay_stop.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserReplayStopInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+    replay_id: str = Field(..., alias="replay_id", description="The replay id returned by browser_replay_start or browser_list_replays.")
+
+
+class BrowserReplayStopOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_screenshot.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserScreenshotInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+
+
+class BrowserScreenshotOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_scroll.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserScrollInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+    delta_y: float | None = Field(None, alias="delta_y", description="Vertical scroll in wheel units. Positive scrolls down, negative up.")
+    delta_x: float | None = Field(None, alias="delta_x", description="Horizontal scroll in wheel units.")
+    x: float | None = Field(None, alias="x", description="X position to scroll at. Defaults to screen center.")
+    y: float | None = Field(None, alias="y", description="Y position to scroll at. Defaults to screen center.")
+
+
+class BrowserScrollOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/browser_type.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BrowserTypeInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    session_id: str = Field(..., alias="session_id", description="The session id returned by browser_open or browser_list_sessions.")
+    text: str = Field(..., alias="text", description="Text to type at the current focus. Click a field first to focus it.")
+    delay: int | None = Field(None, alias="delay", description="Optional per-keystroke delay in ms for human-like typing.")
+
+
+class BrowserTypeOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/bulk_delete_notes.py

@@ -0,0 +1,24 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BulkDeleteNotesInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str | None = Field(None, alias="vault", description="Vault to delete from. Optional; defaults to the session active vault, then the first vault the caller is entitled to.")
+    filters: list[dict[str, Any]] | None = Field(None, alias="filters", description="Filters to AND together. At least one of filters/tags is required.")
+    tags: list[str] | None = Field(None, alias="tags", description="Match notes carrying ANY of these tags (ORed among themselves, ANDed with filters). At least one of filters/tags is required.")
+    dry_run: bool | None = Field(None, alias="dryRun", description="When true (default), previews matches without deleting anything. Pass false to actually delete.")
+
+
+class BulkDeleteNotesOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth/scope/validation error.")
+    vault: str | None = Field(None, alias="vault", description="The vault operated on (after defaulting). Present when ok is true.")
+    dry_run: bool | None = Field(None, alias="dryRun", description="Echoes whether this call was a preview or a real delete.")
+    match_count: float | None = Field(None, alias="matchCount", description="Number of notes matching the filters. Present on a dry run.")
+    sample: list[dict[str, Any]] | None = Field(None, alias="sample", description="Up to 20 matching notes, most-recently-updated first. Present on a dry run.")
+    deleted: float | None = Field(None, alias="deleted", description="Number of notes actually deleted. Present when dryRun is false.")
+    deleted_paths: list[str] | None = Field(None, alias="deletedPaths", description="Paths of the deleted notes. Present when dryRun is false.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/call_service_connection_action.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CallServiceConnectionActionInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    connection_id: str = Field(..., alias="connectionId", description="A connectionId from list_service_connections with actionsEnabled true.")
+    tool: str = Field(..., alias="tool", description="One exact tool name from that connection's actionTools. Arbitrary provider action names and adminBlockedTools are rejected server-side.")
+    args: dict[str, Any] = Field(..., alias="args", description="Arguments required by the selected action. The provider action validates its own typed input before execution.")
+
+
+class CallServiceConnectionActionOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/capture_serp_page_snapshots.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CaptureSerpPageSnapshotsInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    urls: list[str] | None = Field(None, alias="urls", description="Public HTTP/HTTPS URLs to capture. Provide exactly one of urls or targets. Do not pass localhost, private IPs, file URLs, or internal admin URLs.")
+    targets: list[dict[str, Any]] | None = Field(None, alias="targets", description="Structured targets. Provide exactly one of targets or urls; use targets when source kind or position should be preserved.")
+    max_concurrency: int | None = Field(None, alias="maxConcurrency", description="Parallel page captures.")
+    timeout_ms: int | None = Field(None, alias="timeoutMs", description="Per-page capture timeout in milliseconds; timeouts return as structured capture failures.")
+    debug: bool | None = Field(None, alias="debug", description="Include sanitized browser/proxy diagnostics.")
+
+
+class CaptureSerpPageSnapshotsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/capture_serp_snapshot.py

@@ -0,0 +1,22 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CaptureSerpSnapshotInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    query: str = Field(..., alias="query", description="Search query to capture. KEEP the place in the query text for localized captures (e.g. \"botox clinic austin tx\") and also set location.")
+    location: str | None = Field(None, alias="location", description="City, region, country, or service area for localized Google results.")
+    gl: str | None = Field(None, alias="gl", description="Google country code inferred from the requested market.")
+    hl: str | None = Field(None, alias="hl", description="Google interface/content language inferred from the user request.")
+    device: Literal["desktop", "mobile"] | None = Field(None, alias="device", description="SERP device context. Use mobile only for mobile rankings/evidence.")
+    proxy_mode: Literal["location", "configured", "none"] | None = Field(None, alias="proxyMode", description="Leave unset (clean egress). Do NOT set \"location\" just because a city was named — that comes from city-in-query wording. \"location\" forces residential geo-IP, is frequently CAPTCHA-blocked, and accepts failures.")
+    proxy_zip: str | None = Field(None, alias="proxyZip", description="US ZIP for residential geo-IP targeting. Only meaningful with proxyMode \"location\".")
+    pages: int | None = Field(None, alias="pages", description="Google result pages to capture. Use 2 only for deeper ranking evidence.")
+    debug: bool | None = Field(None, alias="debug", description="Include sanitized browser/proxy/location diagnostics.")
+    include_page_snapshots: bool | None = Field(None, alias="includePageSnapshots", description="Also capture ranking-page snapshots for selected SERP URLs. Each attempted snapshot adds 1 Credit.")
+    page_snapshot_limit: int | None = Field(None, alias="pageSnapshotLimit", description="Maximum ranking-page snapshots when includePageSnapshots is true. This capacity is held up front and unused capacity is refunded.")
+
+
+class CaptureSerpSnapshotOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/check_site_export.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CheckSiteExportInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    job_id: str = Field(..., alias="jobId", description="The jobId returned by extract_site or audit_site when called with background (or downloadImages) set — poll this until status is \"complete\" (or \"failed\").")
+
+
+class CheckSiteExportOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/cost_usage.py

@@ -0,0 +1,28 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CostUsageInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    period: str | None = Field(None, alias="period", description="Billing month as YYYY-MM. Optional; defaults to the current month.")
+
+
+class CostUsageOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when usage was computed; false on auth/scope error.")
+    identity: str | None = Field(None, alias="identity", description="The caller identity the costs are scoped to.")
+    period: str | None = Field(None, alias="period", description="Billing month the figures cover (YYYY-MM).")
+    plan: str | None = Field(None, alias="plan", description="Caller plan.")
+    cost_usd: float | None = Field(None, alias="costUsd", description="Total metered cost this period in USD.")
+    by_source: dict[str, Any] | None = Field(None, alias="bySource", description="Cost breakdown by source (llm/embed/storage/compute).")
+    free_cap_usd: float | None = Field(None, alias="freeCapUsd", description="The free-tier monthly processing cap in USD.")
+    free_cap_reached: bool | None = Field(None, alias="freeCapReached", description="True when a free caller is at/over the cap (embeds/optimization paused).")
+    pro_budget_usd: float | None = Field(None, alias="proBudgetUsd", description="The Pro soft fair-use budget (price / 3) in USD.")
+    total_bytes: float | None = Field(None, alias="totalBytes", description="Total stored bytes for the caller.")
+    total_gb: float | None = Field(None, alias="totalGb", description="Total stored GB for the caller.")
+    quota_gb: Any | None = Field(None, alias="quotaGb", description="Storage quota in GB for the caller plan. Null when the plan is unlimited.")
+    unlimited: bool | None = Field(None, alias="unlimited", description="True when the caller is on the unlimited plan (no storage ceiling, exempt from the free cost cap).")
+    by_tier: list[dict[str, Any]] | None = Field(None, alias="byTier", description="Operator-only: blended cost-per-user per plan for the current period.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/create_channel.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CreateChannelInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    name: str = Field(..., alias="name", description="Channel name. Must match ^[A-Za-z0-9 _-]{1,48}$.")
+    invite_members: list[dict[str, Any]] | None = Field(None, alias="inviteMembers", description="Members to invite at creation. Optional; you can also invite later with share-vault.")
+
+
+class CreateChannelOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the channel was created; false on auth/scope/validation error.")
+    channel: str | None = Field(None, alias="channel", description="The channel (vault) name. Present when ok is true.")
+    created: bool | None = Field(None, alias="created", description="True if newly created; false if a vault with this name already existed for you (idempotent).")
+    members: list[dict[str, Any]] | None = Field(None, alias="members", description="Per-member invite result. A member entry with ok:false did NOT block channel creation; invite them again later once approved.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/create_scheduled_action.py

@@ -0,0 +1,25 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CreateScheduledActionInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    description: str = Field(..., alias="description", description="Free-text description of what this action should do each time it runs.")
+    vault: str = Field(..., alias="vault", description="The vault this action writes its results into. You must already have write access to it.")
+    cadence: Literal["once", "daily", "weekly", "monthly"] = Field(..., alias="cadence", description="How often this action runs. \"once\" fires a single time and then completes.")
+    execution_mode: Literal["agent", "connection_sync"] | None = Field(None, alias="executionMode", description="How to execute each run. \"agent\" (default) lets an agent follow the description. \"connection_sync\" deterministically ingests data from the schedule's bound connections using only their approved read-only tools; bind at least one connection before it runs. Search Console connection_sync also maintains a typed table exposed as the connection tableName.")
+    time_of_day: str | None = Field(None, alias="timeOfDay", description="24-hour HH:MM clock time to run at, in the given timezone. Optional — omit to run at any time during the period (matches prior default behavior).")
+    timezone: str | None = Field(None, alias="timezone", description="IANA timezone name, e.g. \"America/Denver\". Only meaningful together with timeOfDay or deployDate. Omit to use the account's default timezone (set via set-schedule-defaults), falling back to UTC.")
+    deploy_date: str | None = Field(None, alias="deployDate", description="Calendar date (YYYY-MM-DD, in the given timezone) this action should first become eligible to run — its deployment/start date. For recurring cadences, the first occurrence lands on or after this date; every later occurrence still follows the normal cadence. For cadence \"once\", this (combined with timeOfDay if given) is exactly what day it fires. Omit to start immediately.")
+
+
+class CreateScheduledActionOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the scheduled action was created.")
+    id: str | None = Field(None, alias="id", description="The new scheduled action id.")
+    next_run_at: str | None = Field(None, alias="nextRunAt", description="When it will first run.")
+    execution_mode: Literal["agent", "connection_sync"] | None = Field(None, alias="executionMode", description="The stored execution mode. Defaults to agent when omitted from the request.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")
+    code: str | None = Field(None, alias="code", description="Machine-readable denial code when creation is refused.")

mcpscraper_memory/mcp_models/create_secure_vault.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CreateSecureVaultInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    name: str = Field(..., alias="name", description="Vault name. Must match ^[A-Za-z0-9 _-]{1,48}$. Defaults to a name like \"Passwords\" if the caller has no preference.")
+
+
+class CreateSecureVaultOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the vault was created; false on auth/scope/validation error.")
+    vault: str | None = Field(None, alias="vault", description="The vault name. Present when ok is true.")
+    created: bool | None = Field(None, alias="created", description="True if newly created; false if a vault with this name already existed for you (idempotent) — note this does NOT confirm the existing vault is secure-kind; check list-vaults if unsure.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/create_webhook.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CreateWebhookInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str | None = Field(None, alias="vault", description="Vault this webhook writes into. Optional; defaults to \"Issues\".")
+    label: str | None = Field(None, alias="label", description="Optional human-readable label to help you remember what this webhook is for, e.g. \"Website contact form\".")
+
+
+class CreateWebhookOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    id: str | None = Field(None, alias="id", description="Webhook id, for listing/revoking later.")
+    url: str | None = Field(None, alias="url", description="The full webhook URL — POST here to write a note.")
+    vault: str | None = Field(None, alias="vault", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/credits_info.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CreditsInfoInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    item: str | None = Field(None, alias="item", description="Optional tool, action, or feature to look up, e.g. \"maps reviews\", \"extract_url\", \"YouTube transcription\", or \"concurrency\"")
+    include_ledger: bool | None = Field(None, alias="includeLedger", description="Whether to include recent credit ledger entries")
+
+
+class CreditsInfoOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")