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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mcpscraper-sdk
-Version: 0.57.2
+Version: 0.57.3
 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
@@ -208,4 +208,4 @@ Publication management: list owned subdomains with `commons_list_publications`,
 
 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.
+Omit the Reddit trending window for an all-time search. Dated searches verify post or comment activity, including when comment text is omitted. See the [0.59.3 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.3) for the compatible package versions.

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

@@ -197,4 +197,4 @@ Publication management: list owned subdomains with `commons_list_publications`,
 
 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.
+Omit the Reddit trending window for an all-time search. Dated searches verify post or comment activity, including when comment text is omitted. See the [0.59.3 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.3) for the compatible package versions.

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

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

{mcpscraper_sdk-0.57.2 → mcpscraper_sdk-0.57.3}/src/mcpscraper/mcp_models/reddit_thread.py

@@ -24,6 +24,7 @@ RedditThreadOutputVariant1CommentsItem = TypedDict('RedditThreadOutputVariant1Co
     'score': Required[Union[str, None]],
     'depth': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'body': Required[str],
+    'publishedAt': NotRequired[str],
 })
 RedditThreadOutputVariant1CommentsItem.__pydantic_config__ = ConfigDict(extra="allow", strict=True)
 

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

@@ -9,9 +9,9 @@ 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', '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.')
+    window: Union[Literal['week', '14d', 'month', 'year', 'all'], None] = Field(None, alias='window', description='Activity window. A post or captured comment must fall within the selected period. Omit for an undated topic search.')
     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.')
+    include_comments: Union[bool, None] = Field(None, alias='includeComments', description='Return captured comments. Dated searches open and bill for verified threads even when comments are omitted. Undated searches with comments omitted return search links without per-thread charges.')
     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.')
 
 
@@ -36,6 +36,7 @@ RedditTrendingOutputVariant1RankedThreadsItemCommentsItem = TypedDict('RedditTre
     'score': Required[str],
     'depth': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'body': Required[str],
+    'publishedAt': NotRequired[str],
 })
 RedditTrendingOutputVariant1RankedThreadsItemCommentsItem.__pydantic_config__ = ConfigDict(extra="allow", strict=True)
 
@@ -45,7 +46,7 @@ RedditTrendingOutputVariant1RankedThreadsItemCommentCoverage = TypedDict('Reddit
     'returnedCount': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'declaredCount': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'status': Required[Literal['complete', 'partial']],
-    'reason': Required[Literal['requested_limit_reached', 'declared_count_reached', 'stable_visible_shortfall', 'capture_shortfall', 'funding_limited']],
+    'reason': Required[Literal['requested_limit_reached', 'declared_count_reached', 'stable_visible_shortfall', 'capture_shortfall', 'funding_limited', 'date_window_filtered']],
 })
 RedditTrendingOutputVariant1RankedThreadsItemCommentCoverage.__pydantic_config__ = ConfigDict(extra="allow", strict=True)
 
@@ -59,6 +60,7 @@ RedditTrendingOutputVariant1RankedThreadsItem = TypedDict('RedditTrendingOutputV
     'engagementScore': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'ageText': Required[str],
     'publishedAt': NotRequired[Union[str, None]],
+    'latestCommentPublishedAt': 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)]],

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

@@ -1946,6 +1946,7 @@ class Comment(BaseModel):
     score: str | None = None
     depth: int | None = None
     body: str | None = None
+    publishedAt: AwareDatetime | None = None
 
 
 class RedditThreadResponse(BaseModel):
@@ -1963,7 +1964,7 @@ class RedditThreadResponse(BaseModel):
 
 class Window(Enum):
     """
-    Publication window; scraped threads are checked against their actual post dates, while discovery-only dates remain unverified.
+    Activity window. A verified post or comment timestamp can qualify a thread.
     """
 
     week = 'week'
@@ -1983,8 +1984,8 @@ class RedditTrendingRequest(BaseModel):
         description='Bare subreddit name to scope the scan, e.g. "SEO" (no r/ prefix). Omit to scan all of Reddit.',
     )
     window: Window = Field(
-        'month',
-        description='Publication window; scraped threads are checked against their actual post dates, while discovery-only dates remain unverified.',
+        'all',
+        description='Activity window. A verified post or comment timestamp can qualify a thread.',
     )
     maxThreads: int = Field(
         20,
@@ -1994,7 +1995,7 @@ class RedditTrendingRequest(BaseModel):
     )
     includeComments: bool = Field(
         True,
-        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.',
+        description='Return captured comment text. Dated results still open and bill for verified threads when false.',
     )
     maxCommentsPerThread: int = Field(
         50,
@@ -2015,6 +2016,7 @@ class Comment1(BaseModel):
     score: str
     depth: int = Field(..., ge=0)
     body: str
+    publishedAt: AwareDatetime | None = None
 
 
 class Question(BaseModel):
@@ -2827,6 +2829,10 @@ class RankedThread(BaseModel):
     publishedAt: AwareDatetime | None = Field(
         None, description='Observed publication timestamp when available.'
     )
+    latestCommentPublishedAt: AwareDatetime | None = Field(
+        None,
+        description='Latest verified captured comment timestamp when comment text is omitted.',
+    )
     comments: list[Comment1] | None = None
     capturedCommentCount: int | None = Field(
         None, description='Text comments actually returned for this thread.', ge=0
@@ -2855,7 +2861,7 @@ class RedditTrendingResponse(BaseModel):
         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.'
+        None, description='The site-scoped query used by the discovery provider.'
     )
     discoverySource: DiscoverySource | None = None
     resultQuality: ResultQuality | None = None