mcpscraper-sdk 0.57.0__tar.gz → 0.57.2__tar.gz

{mcpscraper_sdk-0.57.0 → mcpscraper_sdk-0.57.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mcpscraper-sdk
-Version: 0.57.0
+Version: 0.57.2
 Summary: Official Python client for all 352 mcpscraper.dev MCP tools and the REST API
 Project-URL: Repository, https://github.com/VilovietaSEO/mcpscraper-sdk
 License-Expression: MIT
@@ -13,7 +13,7 @@ Description-Content-Type: text/markdown
 
 Official Python client for the [mcpscraper.dev](https://mcpscraper.dev) REST API — SERP search, People-Also-Ask harvesting, single-page and whole-site extraction, YouTube, Facebook/Google Ads Transparency, Instagram, Reddit, video breakdown, Google Maps, and directory/rank-tracking workflows.
 
-[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.0)
+[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.1)
 
 This is a thin HTTP client generated against [`../../contracts/scraper.openapi.generated.json`](../../contracts/scraper.openapi.generated.json), the complete public REST contract for the hosted API. It contains no scraping, proxy, or billing logic — only typed request/response plumbing over `requests`.
 
@@ -202,6 +202,10 @@ Use `bug_reporting` to prepare a redacted draft from observed calls and errors.
 
 ## Consistent hosted MCP protocol
 
-This release targets MCP Scraper 0.103.0 with 352 tools. Calls use protocol `2026-07-28` with matching routing headers and the required protocol revision, client capabilities and client identity metadata. Poll the returned job/run ID through its dedicated status tool; MCP Task handles are no longer supported. Lead enrichment cancellation uses `lead_list_enrich_cancel`. Update the SDK packages together.
+This release targets MCP Scraper 0.103.10 with 352 tools. Calls use protocol `2026-07-28` with matching routing headers and the required protocol revision, client capabilities and client identity metadata. Poll the returned job/run ID through its dedicated status tool; MCP Task handles are no longer supported. Lead enrichment cancellation uses `lead_list_enrich_cancel`. Update the SDK packages together.
 
 Publication management: list owned subdomains with `commons_list_publications`, select a name with `commons_get_publication`, and edit one article with `commons_update_editorial_article`. Publishing merges omitted articles by default; use `mode:replace` for a full replacement. Use the dedicated article or publication delete tool with its current revision and a stable retry key. See the [release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.0).
+
+PAA job progress can include the optional `phase` and `observedAt` fields. They identify observed extraction work separately from worker renewal. Existing polling and request arguments remain compatible. See [the release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.1).
+
+Reddit trending supports `window: "14d"`, verified publication dates, captured comment text and delivery quality fields. See the [0.59.2 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.2) for the compatible package versions.

{mcpscraper_sdk-0.57.0 → mcpscraper_sdk-0.57.2}/README.md

@@ -2,7 +2,7 @@
 
 Official Python client for the [mcpscraper.dev](https://mcpscraper.dev) REST API — SERP search, People-Also-Ask harvesting, single-page and whole-site extraction, YouTube, Facebook/Google Ads Transparency, Instagram, Reddit, video breakdown, Google Maps, and directory/rank-tracking workflows.
 
-[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.0)
+[Release history](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.1)
 
 This is a thin HTTP client generated against [`../../contracts/scraper.openapi.generated.json`](../../contracts/scraper.openapi.generated.json), the complete public REST contract for the hosted API. It contains no scraping, proxy, or billing logic — only typed request/response plumbing over `requests`.
 
@@ -191,6 +191,10 @@ Use `bug_reporting` to prepare a redacted draft from observed calls and errors.
 
 ## Consistent hosted MCP protocol
 
-This release targets MCP Scraper 0.103.0 with 352 tools. Calls use protocol `2026-07-28` with matching routing headers and the required protocol revision, client capabilities and client identity metadata. Poll the returned job/run ID through its dedicated status tool; MCP Task handles are no longer supported. Lead enrichment cancellation uses `lead_list_enrich_cancel`. Update the SDK packages together.
+This release targets MCP Scraper 0.103.10 with 352 tools. Calls use protocol `2026-07-28` with matching routing headers and the required protocol revision, client capabilities and client identity metadata. Poll the returned job/run ID through its dedicated status tool; MCP Task handles are no longer supported. Lead enrichment cancellation uses `lead_list_enrich_cancel`. Update the SDK packages together.
 
 Publication management: list owned subdomains with `commons_list_publications`, select a name with `commons_get_publication`, and edit one article with `commons_update_editorial_article`. Publishing merges omitted articles by default; use `mode:replace` for a full replacement. Use the dedicated article or publication delete tool with its current revision and a stable retry key. See the [release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.0).
+
+PAA job progress can include the optional `phase` and `observedAt` fields. They identify observed extraction work separately from worker renewal. Existing polling and request arguments remain compatible. See [the release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.1).
+
+Reddit trending supports `window: "14d"`, verified publication dates, captured comment text and delivery quality fields. See the [0.59.2 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.2) for the compatible package versions.

{mcpscraper_sdk-0.57.0 → mcpscraper_sdk-0.57.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcpscraper-sdk"
-version = "0.57.0"
+version = "0.57.2"
 description = "Official Python client for all 352 mcpscraper.dev MCP tools and the REST API"
 readme = "README.md"
 license = "MIT"

{mcpscraper_sdk-0.57.0 → mcpscraper_sdk-0.57.2}/src/mcpscraper/mcp_models/harvest_paa_status.py

@@ -151,6 +151,8 @@ HarvestPaaStatusOutputVariant1ProgressRecentInteractionsItem.__pydantic_config__
 
 
 HarvestPaaStatusOutputVariant1Progress = TypedDict('HarvestPaaStatusOutputVariant1Progress', {
+    'phase': NotRequired[Union[str, None]],
+    'observedAt': NotRequired[Union[str, None]],
     'pagination': Required[Union[HarvestPaaStatusOutputVariant1ProgressPaginationVariant1, None]],
     'requestedQuestions': Required[Union[Annotated[int, Field(ge=0, le=9007199254740991)], None]],
     'capturedQuestions': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],

{mcpscraper_sdk-0.57.0 → mcpscraper_sdk-0.57.2}/src/mcpscraper/mcp_models/reddit_trending.py

@@ -9,8 +9,8 @@ class RedditTrendingInput(BaseModel):
     idempotency_key: Union[Annotated[str, Field(min_length=1, max_length=512)], None] = Field(None, alias='idempotencyKey', description='One logical request identity. Retry identical inputs with the same key to replay or recover without repeating provider work. Omit for a fresh intent; use the key returned with the result or transport error for retries.')
     topic: Annotated[str, Field(min_length=1)] = Field(..., alias='topic', description='Topic to scan (e.g. "crm for small business"). Include quotation marks inside the value for an exact-phrase site search. Not a URL — pass a known thread URL to reddit_thread instead.')
     subreddit: Union[Annotated[str, Field(min_length=1)], None] = Field(None, alias='subreddit', description='Bare subreddit name to scope the scan to one community, e.g. "SEO" (no r/ prefix, no URL). Omit to scan all of Reddit.')
-    window: Union[Literal['week', 'month', 'year', 'all'], None] = Field(None, alias='window', description='Publication window; scraped threads are checked against their actual post dates, while discovery-only dates remain unverified.')
-    max_threads: Union[Annotated[int, Field(ge=1, le=40)], None] = Field(None, alias='maxThreads', description='Cap on relevant threads selected before scraping; one search page can yield fewer. Each scraped thread and its returned comments are billed separately.')
+    window: Union[Literal['week', '14d', 'month', 'year', 'all'], None] = Field(None, alias='window', description='Publication window; scraped threads are checked against their actual post dates, while discovery-only dates remain unverified.')
+    max_threads: Union[Annotated[int, Field(ge=1, le=40)], None] = Field(None, alias='maxThreads', description='Maximum number of threads returned. If a candidate cannot be delivered, other relevant candidates can take its place. Each delivered thread and its comments are billed separately.')
     include_comments: Union[bool, None] = Field(None, alias='includeComments', description='Open selected threads to verify post dates and collect comments; false returns search candidates for your own selection, without per-thread charges or verified post dates.')
     max_comments_per_thread: Union[Annotated[int, Field(ge=1, le=200)], None] = Field(None, alias='maxCommentsPerThread', description='Comments captured per scraped thread when includeComments is true. Default 50. Billed per captured comment.')
 
@@ -31,6 +31,15 @@ RedditTrendingOutputVariant1Totals = TypedDict('RedditTrendingOutputVariant1Tota
 RedditTrendingOutputVariant1Totals.__pydantic_config__ = ConfigDict(extra="allow", strict=True)
 
 
+RedditTrendingOutputVariant1RankedThreadsItemCommentsItem = TypedDict('RedditTrendingOutputVariant1RankedThreadsItemCommentsItem', {
+    'author': Required[str],
+    'score': Required[str],
+    'depth': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
+    'body': Required[str],
+})
+RedditTrendingOutputVariant1RankedThreadsItemCommentsItem.__pydantic_config__ = ConfigDict(extra="allow", strict=True)
+
+
 RedditTrendingOutputVariant1RankedThreadsItemCommentCoverage = TypedDict('RedditTrendingOutputVariant1RankedThreadsItemCommentCoverage', {
     'requestedLimit': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'returnedCount': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
@@ -50,6 +59,7 @@ RedditTrendingOutputVariant1RankedThreadsItem = TypedDict('RedditTrendingOutputV
     'engagementScore': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'ageText': Required[str],
     'publishedAt': NotRequired[Union[str, None]],
+    'comments': NotRequired[list[RedditTrendingOutputVariant1RankedThreadsItemCommentsItem]],
     'capturedCommentCount': NotRequired[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'requestedCommentLimit': NotRequired[Annotated[int, Field(ge=1, le=9007199254740991)]],
     'commentCoverage': NotRequired[RedditTrendingOutputVariant1RankedThreadsItemCommentCoverage],

{mcpscraper_sdk-0.57.0 → mcpscraper_sdk-0.57.2}/src/mcpscraper/mcp_models/search_serp.py

@@ -7,7 +7,7 @@ class SearchSerpInput(BaseModel):
     model_config = ConfigDict(populate_by_name=True, extra="allow", strict=False)
 
     mode: Union[Literal['light', 'full'], None] = Field(None, alias='mode', description='Light returns organic results. Full adds available same-page features for an unfiltered one-page search. Date-filtered, two-page, and browser-backup results contain organic listings only and mark rich features unsupported.')
-    query: Annotated[str, Field(min_length=1)] = Field(..., alias='query', description='The search topic, exactly as it should be searched. Include the place here when you want it in the search terms — the server sends your query to Google unchanged and never adds or removes a location.')
+    query: Annotated[str, Field(min_length=1)] = Field(..., alias='query', description='Search terms, including any desired location. The first query is sent unchanged. A one-page light search that returns only off-domain rows for a Reddit site scope can retry with a narrower Reddit thread scope.')
     location: Union[str, None] = Field(None, alias='location', description='Compatibility field. Ordinary search ignores this. Include a place in query when needed.')
     gl: Union[Annotated[str, Field(min_length=2, max_length=2)], None] = Field(None, alias='gl', description='Compatibility field. Ordinary search uses its fixed default market.')
     hl: Union[str, None] = Field(None, alias='hl', description='Compatibility field. Ordinary search uses its fixed default language.')

{mcpscraper_sdk-0.57.0 → mcpscraper_sdk-0.57.2}/src/mcpscraper/models.py

@@ -1967,6 +1967,7 @@ class Window(Enum):
     """
 
     week = 'week'
+    field_14d = '14d'
     month = 'month'
     year = 'year'
     all = 'all'
@@ -1987,7 +1988,7 @@ class RedditTrendingRequest(BaseModel):
     )
     maxThreads: int = Field(
         20,
-        description='Cap on relevant threads selected before scraping; one search page can yield fewer. Each scraped thread and its returned comments are billed separately.',
+        description='Maximum number of relevant threads to deliver. Each scraped thread and its returned comments are billed separately.',
         ge=1,
         le=40,
     )
@@ -2009,11 +2010,24 @@ class Totals(BaseModel):
     comments: int | None = None
 
 
+class Comment1(BaseModel):
+    author: str
+    score: str
+    depth: int = Field(..., ge=0)
+    body: str
+
+
 class Question(BaseModel):
     question: str | None = None
     threadUrl: str | None = None
 
 
+class DiscoverySource(Enum):
+    google_serp = 'google_serp'
+    reddit_search_fallback = 'reddit_search_fallback'
+    none = 'none'
+
+
 class RedditCommentCoverageStatus(Enum):
     complete = 'complete'
     partial = 'partial'
@@ -2813,6 +2827,7 @@ class RankedThread(BaseModel):
     publishedAt: AwareDatetime | None = Field(
         None, description='Observed publication timestamp when available.'
     )
+    comments: list[Comment1] | None = None
     capturedCommentCount: int | None = Field(
         None, description='Text comments actually returned for this thread.', ge=0
     )
@@ -2827,7 +2842,8 @@ class RedditTrendingResponse(BaseModel):
     topic: str | None = None
     subreddit: str | None = None
     window: str | None = Field(
-        None, description='Resolved publication window: "7d", "30d", "365d" or "all".'
+        None,
+        description='Resolved publication window: "7d", "14d", "30d", "365d" or "all".',
     )
     totals: Totals | None = None
     rankedThreads: list[RankedThread] | None = None
@@ -2835,11 +2851,18 @@ class RedditTrendingResponse(BaseModel):
     threadsScraped: int | None = None
     candidatesFound: int | None = None
     partial: bool | None = Field(
-        None, description='true if scraping stopped early at the time limit.'
+        None,
+        description='True when coverage is partial or the requested delivery target was missed.',
     )
     searchQuery: str | None = Field(
         None, description='The Google site:reddit.com query used for discovery.'
     )
+    discoverySource: DiscoverySource | None = None
+    resultQuality: ResultQuality | None = None
+    degradedResult: bool | None = None
+    degradationReasons: list[str] | None = None
+    retryRecommended: bool | None = None
+    billingRefunded: bool | None = None
 
 
 SerpIntelligencePaaNode.model_rebuild()