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

mcpscraper_memory/mcp_models/delete_note.py

@@ -0,0 +1,23 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class DeleteNoteInput(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.")
+    path: str | None = Field(None, alias="path", description="Exact vault-relative note path to delete, e.g. projects/q3-plan (as returned by memory-list or recall). Required unless shareId is given.")
+    share_id: str | None = Field(None, alias="shareId", description="Destroy a note shared with you and you accepted, by its shareId, instead of vault+path. Requires the share to grant delete permission and baseRevision (mandatory for shared notes).")
+    base_revision: float | None = Field(None, alias="baseRevision", description="Revision the delete is based on (from a prior get). When provided, the delete only applies if the note is still at this revision; otherwise it is rejected as a conflict instead of destroying a concurrent edit. Mandatory when shareId is given; optional otherwise (omit to delete unconditionally).")
+
+
+class DeleteNoteOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the delete request was processed; false on an auth/scope/lookup error or a revision conflict.")
+    vault: str | None = Field(None, alias="vault", description="The vault the delete was applied to (after defaulting). Present when ok is true.")
+    deleted: bool | None = Field(None, alias="deleted", description="True if a note was removed; false if no matching note existed (idempotent). Present when ok is true.")
+    conflict: bool | None = Field(None, alias="conflict", description="True when baseRevision did not match the current revision: someone else changed the note first. Nothing was deleted.")
+    current: dict[str, Any] | None = Field(None, alias="current", description="Present only when conflict is true: the note as it stands now, so the caller can re-read before deciding whether to still delete.")
+    code: str | None = Field(None, alias="code", description="Machine-readable denial code when ok is false: revision_conflict.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/delete_scheduled_action.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class DeleteScheduledActionInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    id: str = Field(..., alias="id", description="The scheduled action id.")
+
+
+class DeleteScheduledActionOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    deleted: bool | None = Field(None, alias="deleted", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/delete_vault.py

@@ -0,0 +1,18 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class DeleteVaultInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str = Field(..., alias="vault", description="Exact name of the vault to delete. The caller must own this vault and hold admin scope on it.")
+
+
+class DeleteVaultOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the vault was deleted; false on auth/scope/ownership error.")
+    vault: str | None = Field(None, alias="vault", description="The deleted vault name. Present when ok is true.")
+    deleted_notes: float | None = Field(None, alias="deletedNotes", description="Number of notes removed from the vault. Present when ok is true.")
+    deleted_facts: float | None = Field(None, alias="deletedFacts", description="Number of facts (active + superseded) removed from the vault. Present when ok is true.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/describe_service_connection_tool.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class DescribeServiceConnectionToolInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    connection_id: str = Field(..., alias="connectionId", description="A tenant-owned connectionId from list_service_connections.")
+    tool: str = Field(..., alias="tool", description="One exact name from that connection's readTools or actionTools. Admin-blocked and arbitrary names are rejected.")
+    fresh: bool | None = Field(None, alias="fresh", description="Bypass the short-lived sanitized schema cache. Ownership, connection state, and tool policy are still rechecked; use only when a provider tool catalog just changed.")
+
+
+class DescribeServiceConnectionToolOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/diff_page.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class DiffPageInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    url: str = Field(..., alias="url", description="Public http/https URL to check for changes since the last diff_page call.")
+    allow_local: bool | None = Field(None, alias="allowLocal", description="Allow localhost and private-network URLs. Local development only.")
+    reset_baseline: bool | None = Field(None, alias="resetBaseline", description="Discard any previously stored snapshot for this URL and capture the current content as a fresh baseline instead of diffing against history. Use when you deliberately want to restart change tracking.")
+
+
+class DiffPageOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/directory_workflow.py

@@ -0,0 +1,24 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class DirectoryWorkflowInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    query: str = Field(..., alias="query", description="Business category, niche, or keyword to search on Google Maps for every market. Do not include the city.")
+    state: str | None = Field(None, alias="state", description="US state abbreviation or name used to select Census places, e.g. TN.")
+    min_population: int | None = Field(None, alias="minPopulation", description="Minimum Census place population for market selection.")
+    population_year: int | None = Field(None, alias="populationYear", description="Census population estimate year (2020-2025 Population Estimates Program).")
+    max_cities: int | None = Field(None, alias="maxCities", description="Maximum markets to process after sorting by population descending.")
+    max_results_per_city: int | None = Field(None, alias="maxResultsPerCity", description="Google Maps candidates to collect per city.")
+    concurrency: int | None = Field(None, alias="concurrency", description="City Maps searches to run in parallel.")
+    include_zip_groups: bool | None = Field(None, alias="includeZipGroups", description="Attach ZIP groups from a configured US ZIPS CSV when available (MCP_SCRAPER_USZIPS_CSV_PATH or usZipsCsvPath).")
+    us_zips_csv_path: str | None = Field(None, alias="usZipsCsvPath", description="Local/test-only path to a US ZIPS CSV (state_abbr, zipcode, county, city columns). Deployed APIs should use MCP_SCRAPER_USZIPS_CSV_PATH instead. For ZIP enrichment, set MCP_SCRAPER_USZIPS_CSV_PATH on the server, or pass this in local/test mode.")
+    save_csv: bool | None = Field(None, alias="saveCsv", description="Save a directory-ready CSV of results to the MCP Scraper output directory and return its path.")
+    proxy_mode: Literal["location", "configured", "none"] | None = Field(None, alias="proxyMode", description="Proxy behavior per city search. Leave unset for the direct localized Google route; location is an explicit residential-proxy override.")
+    proxy_zip: str | None = Field(None, alias="proxyZip", description="Optional ZIP override for proxy targeting; normally omitted.")
+    debug: bool | None = Field(None, alias="debug", description="Include sanitized browser/proxy diagnostics.")
+
+
+class DirectoryWorkflowOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/export_connected_service_data.py

@@ -0,0 +1,20 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ExportConnectedServiceDataInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    connection_id: str = Field(..., alias="connectionId", description="A tenant-owned connectionId from list_service_connections.")
+    dataset: Literal["auto", "emails", "calendar_events", "zoom_recordings", "zoom_transcripts", "meta_ads_insights", "search_console_performance", "resend_data", "resend_emails", "resend_received_emails", "resend_logs", "resend_contacts", "resend_broadcasts", "resend_templates"] | None = Field(None, alias="dataset", description="Dataset to export. auto maps Gmail to emails, Google Calendar to calendar_events, Zoom to zoom_transcripts, Meta Marketing to meta_ads_insights, Google Search Console to search_console_performance, and Resend to resend_data. Search Console walks bounded Search Analytics rows across every accessible property. Meta walks daily account, campaign, ad-set, and ad insight levels across the connected ad accounts. The Resend aggregate walks 12 practical safe collections; six core collections are also individually selectable.")
+    last_days: int | None = Field(None, alias="lastDays", description="Relative range ending at to (or now). Defaults to 7 when from is omitted. Do not pass together with from.")
+    from_: str | None = Field(None, alias="from", description="Inclusive RFC3339 range start. Use instead of lastDays.")
+    to: str | None = Field(None, alias="to", description="Exclusive RFC3339 range end. Defaults to now.")
+    max_items: int | None = Field(None, alias="maxItems", description="Maximum records to include in this export invocation. Pagination and detail retrieval happen server-side.")
+    delivery: Literal["auto", "artifact"] | None = Field(None, alias="delivery", description="auto returns small results inline and stores larger results in private Blob. artifact always creates a private downloadable JSONL artifact.")
+    continuation: dict[str, Any] | None = Field(None, alias="continuation", description="Preferred resume input. Pass the entire continuation object returned by a prior partial export unchanged; it preserves the exact original range and dataset.")
+    cursor: str | None = Field(None, alias="cursor", description="Legacy resume input. When used, also pass the exact original from, to, and dataset. Prefer continuation.")
+
+
+class ExportConnectedServiceDataOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/export_search_console_table_data.py

@@ -0,0 +1,15 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ExportSearchConsoleTableDataInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    table_name: str = Field(..., alias="tableName", description="Typed Search Console tableName returned by list_service_connections after a successful connection_sync run.")
+    filters: list[dict[str, Any]] | None = Field(None, alias="filters", description="Optional filters to AND together before download. Use table-describe or the documented typed columns.")
+    sort: dict[str, Any] | None = Field(None, alias="sort", description="Optional row ordering for the JSONL download.")
+    max_rows: int | None = Field(None, alias="maxRows", description="Maximum matching persisted rows to place in this artifact. Use filters to bound large tables.")
+
+
+class ExportSearchConsoleTableDataOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/extract_site.py

@@ -0,0 +1,18 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ExtractSiteInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    url: str = Field(..., alias="url", description="Public website URL or domain to crawl for page CONTENT (map + scrape). For a technical SEO audit use audit_site instead — this returns content only, not analysis.")
+    max_pages: int | None = Field(None, alias="maxPages", description="Maximum pages to extract. Bulk crawls (over 25 pages) switch to folder mode: each page saved as its own Markdown file, with a summary plus folder path returned instead of inlining content.")
+    rotate_proxies: bool | None = Field(None, alias="rotateProxies", description="Route page fetches through rotating residential proxies to defeat rate-limiting and bot blocks (403/429). Slower and 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.")
+    formats: list[Literal["markdown", "links", "json", "images", "branding"]] | None = Field(None, alias="formats", description="Per-page output formats: markdown, links, json, images are captured cheaply from HTML; branding (site-level logo/colors/fonts) requires a browser and adds time. Defaults to markdown+links.")
+    background: bool | None = Field(None, alias="background", description="Run the crawl as a background job instead of blocking this call, returning a jobId immediately — poll it with check_site_export to get a downloadable zip (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 ExtractSiteOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/extract_url.py

@@ -0,0 +1,20 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ExtractUrlInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    url: str = Field(..., alias="url", description="Public http/https URL to extract.")
+    screenshot: bool | None = Field(None, alias="screenshot", description="Capture a full-page screenshot, saved to ~/Downloads/mcp-scraper/screenshots/ and returned inline.")
+    screenshot_device: Literal["desktop", "mobile"] | None = Field(None, alias="screenshotDevice", description="Viewport for screenshot. desktop = 1440×900, mobile = 390×844.")
+    extract_branding: bool | None = Field(None, alias="extractBranding", description="Extract brand colors, fonts, logo, and favicon via a rendered browser session.")
+    download_media: bool | None = Field(None, alias="downloadMedia", description="Extract and download page media (images/video/audio) to ~/Downloads/mcp-scraper/media/. Ad/tracking noise is filtered automatically.")
+    media_types: list[Literal["image", "video", "audio"]] | None = Field(None, alias="mediaTypes", description="Which media types to download. Default all three.")
+    allow_local: bool | None = Field(None, alias="allowLocal", description="Allow localhost and private-network URLs. Local development only.")
+    deposit_to_vault: bool | None = Field(None, alias="depositToVault", description="Save the full page content into the user's MCP Memory vault server-side, embedded for semantic recall — the full body is NOT returned to chat.")
+    vault_name: str | None = Field(None, alias="vaultName", description="Optional vault to deposit into. Defaults to the user's personal vault.")
+
+
+class ExtractUrlOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/facebook_ad_search.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class FacebookAdSearchInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    query: str = Field(..., alias="query", description="Advertiser, brand, competitor, niche, or keyword to search in Facebook Ad Library.")
+    country: str | None = Field(None, alias="country", description="Two-letter Ad Library country code. Default US. Examples: US, CA, GB, AU.")
+    max_results: int | None = Field(None, alias="maxResults", description="Maximum advertisers to return. Default 10, maximum 20. Prefer tighter search terms over maxing this out.")
+
+
+class FacebookAdSearchOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/facebook_ad_transcribe.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class FacebookAdTranscribeInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    video_url: str = Field(..., alias="videoUrl", description="Direct Meta/Facebook CDN video URL from facebook_page_intel or meta_ad_creative_media. Use transient sources immediately. Do not pass a public post/reel/share URL—use facebook_video_transcribe for those.")
+
+
+class FacebookAdTranscribeOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/facebook_page_intel.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class FacebookPageIntelInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    page_id: str | None = Field(None, alias="pageId", description="Facebook advertiser/page ID. Use only a value returned by facebook_ad_search or copied from Ad Library.")
+    library_id: str | None = Field(None, alias="libraryId", description="Facebook Ad Library archive ID. Use a value returned by facebook_ad_search, or a libraryId/adArchiveId visible in Ad Library.")
+    query: str | None = Field(None, alias="query", description="Broad Ad Library keyword discovery when pageId/libraryId is not known. Results can mix unrelated advertisers; inspect matchConfidence, matchedAdvertisers, and warnings before analysis. One of pageId, libraryId, or query is required.")
+    max_ads: int | None = Field(None, alias="maxAds", description="Maximum ads to inspect. Default 50, maximum 200.")
+    country: str | None = Field(None, alias="country", description="Two-letter Ad Library country code. Default US.")
+
+
+class FacebookPageIntelOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/facebook_video_transcribe.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class FacebookVideoTranscribeInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    url: str = Field(..., alias="url", description="Public Facebook reel/video/watch/post/share URL from facebook.com, m.facebook.com, or fb.watch. For connected account ads, get the correct public candidate from meta_ad_creative_media instead of guessing URL structure.")
+    quality: Literal["best", "hd", "sd"] | None = Field(None, alias="quality", description="Preferred progressive MP4 quality. Use best by default; hd prefers the highest HD progressive URL; sd forces the SD URL.")
+
+
+class FacebookVideoTranscribeOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/fact_history.py

@@ -0,0 +1,18 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class FactHistoryInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str | None = Field(None, alias="vault", description="Vault to read from. Optional; defaults to the session active vault, then the first vault the caller is entitled to.")
+    subject: str = Field(..., alias="subject", description="The subject whose history to read (e.g. \"db preference\"). Canonicalized to match how it was recorded.")
+
+
+class FactHistoryOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the history was read; false on an auth/scope error.")
+    current: Any | None = Field(None, alias="current", description="The current active fact for the subject, or null if none exists. Present when ok is true.")
+    history: list[Any] | None = Field(None, alias="history", description="The superseded chain newest → oldest — the audit trail. Empty when nothing has been superseded. Present when ok is true.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/g2_reviews.py

@@ -0,0 +1,13 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class G2ReviewsInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    product: str = Field(..., alias="product", description="The product's G2 URL slug, e.g. \"notion\" from g2.com/products/notion/reviews (also accepts a full g2.com product URL).")
+    max_pages: int | None = Field(None, alias="maxPages", description="Review pages to fetch (~10 reviews per page). Default 5 (~50 reviews). Maximum 50 — this tool is for sampling, not full-corpus export.")
+
+
+class G2ReviewsOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/get_chat_link.py

@@ -0,0 +1,15 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GetChatLinkInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class GetChatLinkOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    url: str | None = Field(None, alias="url", description="The chat link. Present only the first time a link is minted for this identity.")
+    already_exists: bool | None = Field(None, alias="alreadyExists", description="True when a link already exists and was NOT re-shown. Use revoke-chat-link then call this again to get a fresh one.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/get_message_note.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GetMessageNoteInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str = Field(..., alias="vault", description="The channel (vault) the message is in.")
+    message_id: str = Field(..., alias="messageId", description="The message (from list-channel-messages / poll-channel) whose attached note to read.")
+
+
+class GetMessageNoteOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the note was found and readable; false on auth/scope/not-found error.")
+    note: dict[str, Any] | None = Field(None, alias="note", description="Present when ok is true.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/get_schedule_link.py

@@ -0,0 +1,16 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GetScheduleLinkInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class GetScheduleLinkOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True on success; false on auth error.")
+    url: str | None = Field(None, alias="url", description="The schedule link. Present only the first time a link is minted for this identity.")
+    already_exists: bool | None = Field(None, alias="alreadyExists", description="True when a link already exists and was NOT re-shown. Use revoke-schedule-link then call this again to get a fresh one.")
+    code: str | None = Field(None, alias="code", description="Machine-readable denial code when the link cannot be issued.")
+    error: str | None = Field(None, alias="error", description="Human-readable failure reason when ok is false.")

mcpscraper_memory/mcp_models/get_schedule_status.py

@@ -0,0 +1,22 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GetScheduleStatusInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class GetScheduleStatusOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    enabled: bool | None = Field(None, alias="enabled", description="")
+    billing_mode: str | None = Field(None, alias="billingMode", description="")
+    run_base_credits: float | None = Field(None, alias="runBaseCredits", description="")
+    llm_cost_multiplier: float | None = Field(None, alias="llmCostMultiplier", description="")
+    quota_per_period: float | None = Field(None, alias="quotaPerPeriod", description="")
+    used_this_period: float | None = Field(None, alias="usedThisPeriod", description="")
+    period_start: str | None = Field(None, alias="periodStart", description="")
+    default_timezone: Any | None = Field(None, alias="defaultTimezone", description="IANA timezone applied to new schedules that name a time without a zone; null means UTC.")
+    code: str | None = Field(None, alias="code", description="Machine-readable reason scheduling is unavailable.")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/get_vault_app_link.py

@@ -0,0 +1,15 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GetVaultAppLinkInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class GetVaultAppLinkOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="True when the request succeeded.")
+    url: str | None = Field(None, alias="url", description="Vault App link. Present only when the secret is first minted; anyone holding it can use the Vault App as this identity.")
+    already_exists: bool | None = Field(None, alias="alreadyExists", description="True when an active Vault App link exists but its secret cannot be shown again.")
+    error: str | None = Field(None, alias="error", description="Human-readable error when the request cannot be completed.")

mcpscraper_memory/mcp_models/get_vault_contract.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GetVaultContractInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    vault: str = Field(..., alias="vault", description="One governed vault: Ideas, Inspiration, Knowledge, Library, People, Communications, Calendar, Tasks, Projects, Issues, Improvement Log, Experiments, or Sprint.")
+
+
+class GetVaultContractOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    ok: bool = Field(..., alias="ok", description="")
+    vault: str | None = Field(None, alias="vault", description="")
+    contract: dict[str, Any] | None = Field(None, alias="contract", description="")
+    error: str | None = Field(None, alias="error", description="")

mcpscraper_memory/mcp_models/gmail_send_message.py

@@ -0,0 +1,15 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GmailSendMessageInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    connection_id: str = Field(..., alias="connectionId", description="A Gmail connectionId from list_service_connections, with actionsEnabled true.")
+    to: str = Field(..., alias="to", description="Recipient email address.")
+    subject: str = Field(..., alias="subject", description="Email subject line.")
+    body: str = Field(..., alias="body", description="Plain-text email body.")
+
+
+class GmailSendMessageOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/google_ads_page_intel.py

@@ -0,0 +1,15 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GoogleAdsPageIntelInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    advertiser_id: str | None = Field(None, alias="advertiserId", description="Google Ads Transparency advertiser ID (starts with AR...). Use one returned by google_ads_search; do not construct one yourself.")
+    domain: str | None = Field(None, alias="domain", description="A domain (e.g. getviktor.com) whose primary advertiser to inspect when advertiserId is unknown. One of advertiserId or domain is required.")
+    region: str | None = Field(None, alias="region", description="Two-letter region code for where the ads are shown. Default US.")
+    max_ads: int | None = Field(None, alias="maxAds", description="Maximum creatives to inspect and hydrate. Default 50, maximum 200. Prefer 25-50 for focused scans.")
+
+
+class GoogleAdsPageIntelOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/google_ads_search.py

@@ -0,0 +1,14 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GoogleAdsSearchInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    query: str = Field(..., alias="query", description="A domain (e.g. getviktor.com) or advertiser/brand name to look up in Google Ads Transparency Center.")
+    region: str | None = Field(None, alias="region", description="Two-letter region code for where the ads are shown. Default US. Examples: US, CA, GB, AU.")
+    max_results: int | None = Field(None, alias="maxResults", description="Maximum advertisers to return. Default 10, maximum 20.")
+
+
+class GoogleAdsSearchOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/google_ads_transcribe.py

@@ -0,0 +1,12 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GoogleAdsTranscribeInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    video_url: str = Field(..., alias="videoUrl", description="Direct googlevideo.com playback URL from google_ads_page_intel. For YouTube-hosted ads use youtube_transcribe instead.")
+
+
+class GoogleAdsTranscribeOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/google_calendar_create_event.py

@@ -0,0 +1,20 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class GoogleCalendarCreateEventInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    connection_id: str = Field(..., alias="connectionId", description="A Google Calendar connectionId from list_service_connections, with actionsEnabled true.")
+    calendar_id: str | None = Field(None, alias="calendarId", description="Calendar to create the event in. Default \"primary\".")
+    summary: str = Field(..., alias="summary", description="Event title.")
+    description: str = Field(..., alias="description", description="Required event context. Include the purpose or agenda supplied by the user and the Zoom join link when one was created.")
+    location: str | None = Field(None, alias="location", description="Event location.")
+    start_date_time: str = Field(..., alias="startDateTime", description="Start time, ISO 8601, e.g. \"2026-07-15T09:00:00-06:00\".")
+    end_date_time: str = Field(..., alias="endDateTime", description="End time, ISO 8601, e.g. \"2026-07-15T10:00:00-06:00\".")
+    time_zone: str | None = Field(None, alias="timeZone", description="IANA timezone, e.g. \"America/Denver\". Applies to both start and end.")
+    attendees: list[dict[str, Any]] = Field(..., alias="attendees", description="Required attendee list. Include every person the user asked to invite; use an empty array only when no invitee was identified.")
+
+
+class GoogleCalendarCreateEventOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/harvest_paa.py

@@ -0,0 +1,20 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class HarvestPaaInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    query: str = Field(..., alias="query", description="The search query. KEEP the place in the query text for localized results (e.g. \"best hvac company Denver CO\") and also set location — city-in-query is what localizes reliably.")
+    location: str | None = Field(None, alias="location", description="City, region, or country for geo signals, e.g. \"Denver, CO\". Set alongside city-in-query wording; alone it does NOT reliably localize.")
+    max_questions: int | None = Field(None, alias="maxQuestions", description="PAA questions to extract. Default 30, maximum 200. Use 10 for quick probes, 100-200 for deep research. Billed per extracted question; unused hold refunded.")
+    gl: str | None = Field(None, alias="gl", description="Google country code inferred from location or user language.")
+    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.")
+    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 for rank-tracking fidelity, 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\".")
+    debug: bool | None = Field(None, alias="debug", description="Include sanitized diagnostics for debugging localization, CAPTCHA, or proxy behavior.")
+
+
+class HarvestPaaOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/import_service_connection_to_memory.py

@@ -0,0 +1,17 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ImportServiceConnectionToMemoryInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    connection_id: str = Field(..., alias="connectionId", description="A tenant-owned connectionId from list_service_connections.")
+    provider_config_key: str = Field(..., alias="providerConfigKey", description="The exact providerConfigKey returned with that connection. It is matched together with connectionId against the authenticated caller.")
+    tool: str = Field(..., alias="tool", description="One exact current readTools entry for that connection. Actions, admin tools, and unlisted names are rejected.")
+    args: dict[str, Any] | None = Field(None, alias="args", description="JSON arguments for one bounded provider read. The serialized object may be at most 64 KiB.")
+    vault: str = Field(..., alias="vault", description="An existing ordinary Memory vault the caller can write and index. Secure and channel vaults are rejected because this tool creates searchable RAG content.")
+    title: str | None = Field(None, alias="title", description="Optional human-readable snapshot title. The server always chooses the stable storage path.")
+
+
+class ImportServiceConnectionToMemoryOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/instagram_media_download.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class InstagramMediaDownloadInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    url: str = Field(..., alias="url", description="Instagram post, reel, or tv URL, e.g. https://www.instagram.com/reel/SHORTCODE/.")
+    profile: str | None = Field(None, alias="profile", description="Optional saved hosted browser profile name for authenticated Instagram access.")
+    save_profile_changes: bool | None = Field(None, alias="saveProfileChanges", description="Save browser changes back to the hosted profile. Leave unset unless intentionally updating the saved login.")
+    media_types: list[Literal["image", "video", "audio"]] | None = Field(None, alias="mediaTypes", description="Which media types to download when downloadMedia is true.")
+    download_media: bool | None = Field(None, alias="downloadMedia", description="Download extracted text/media files to the output directory. Media URLs are always returned even when false.")
+    download_all_tracks: bool | None = Field(None, alias="downloadAllTracks", description="Download every captured MP4 track instead of only the best video/audio pair.")
+    include_transcript: bool | None = Field(None, alias="includeTranscript", description="Transcribe the selected audio track. Adds transcription cost and time.")
+    mux: bool | None = Field(None, alias="mux", description="Mux separately downloaded video/audio tracks into one MP4 if ffmpeg is available.")
+
+
+class InstagramMediaDownloadOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

mcpscraper_memory/mcp_models/instagram_profile_content.py

@@ -0,0 +1,19 @@
+from typing import Any, Literal
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class InstagramProfileContentInput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+    handle: str | None = Field(None, alias="handle", description="Instagram handle, with or without @. Provide handle or url.")
+    url: str | None = Field(None, alias="url", description="Instagram profile URL. Provide handle or url.")
+    profile: str | None = Field(None, alias="profile", description="Optional saved hosted browser profile name for authenticated Instagram access.")
+    save_profile_changes: bool | None = Field(None, alias="saveProfileChanges", description="Save browser changes back to the hosted profile. Leave unset unless intentionally updating the saved login.")
+    max_items: int | None = Field(None, alias="maxItems", description="Maximum grid URLs to collect. Default 50, maximum 2000.")
+    max_scrolls: int | None = Field(None, alias="maxScrolls", description="Maximum pagination scroll attempts. Default 10, maximum 250.")
+    scroll_delay_ms: int | None = Field(None, alias="scrollDelayMs", description="Delay after each scroll before collecting new links. Default 1200ms.")
+    stable_scroll_limit: int | None = Field(None, alias="stableScrollLimit", description="Stop after this many consecutive scrolls with no new links.")
+
+
+class InstagramProfileContentOutput(BaseModel):
+    model_config = ConfigDict(populate_by_name=True, extra="allow")