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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mcpscraper-sdk
-Version: 0.57.2
+Version: 0.57.4
 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.
+Use Reddit Trends review mode to preview links, approve mode to fetch selected threads, or auto mode to search and fetch in one call. See the [0.59.4 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.4) for the compatible package versions.

{mcpscraper_sdk-0.57.2 → mcpscraper_sdk-0.57.4}/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.
+Use Reddit Trends review mode to preview links, approve mode to fetch selected threads, or auto mode to search and fetch in one call. See the [0.59.4 release notes](https://github.com/VilovietaSEO/mcpscraper-sdk/releases/tag/v0.59.4) for the compatible package versions.

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

@@ -1,6 +1,6 @@
 [project]
 name = "mcpscraper-sdk"
-version = "0.57.2"
+version = "0.57.4"
 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.4}/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.4}/src/mcpscraper/mcp_models/reddit_trending.py

@@ -7,11 +7,14 @@ class RedditTrendingInput(BaseModel):
     model_config = ConfigDict(populate_by_name=True, extra="allow", strict=False)
 
     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.')
+    topic: Union[Annotated[str, Field(min_length=1)], None] = Field(None, alias='topic', description='Topic to search. Required for discovery. Approve mode uses the original review topic and options.')
+    approval_mode: Union[Literal['review', 'approve', 'auto'], None] = Field(None, alias='approvalMode', description='Use review to preview links, approve after the user selects links, or auto when the user wants immediate fetching.')
+    review_id: Union[str, None] = Field(None, alias='reviewId', description='ID returned by review mode. Required in approve mode.')
+    approved_urls: Union[Annotated[list[Annotated[str, Field(min_length=1, max_length=2048)]], Field(min_length=1, max_length=40)], None] = Field(None, alias='approvedUrls', description='Only the URLs the user approved from this review. Required in approve mode.')
     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.')
-    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.')
+    window: Union[Literal['week', '14d', 'month', 'year', 'all'], None] = Field(None, alias='window', description='Activity window. Review uses it as a search hint. Fetching verifies that a post or captured comment falls in the window.')
+    max_threads: Union[Annotated[int, Field(ge=1, le=40)], None] = Field(None, alias='maxThreads', description='Maximum links shown in review mode, or threads returned when fetching.')
+    include_comments: Union[bool, None] = Field(None, alias='includeComments', description='Return captured comments when fetching. Review only lists links. In the default mode, undated searches with comments omitted return links without opening threads.')
     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.')
 
 
@@ -23,6 +26,13 @@ RedditTrendingOutputVariant1Operation = TypedDict('RedditTrendingOutputVariant1O
 RedditTrendingOutputVariant1Operation.__pydantic_config__ = ConfigDict(extra="allow", strict=True)
 
 
+RedditTrendingOutputVariant1Review = TypedDict('RedditTrendingOutputVariant1Review', {
+    'id': Required[str],
+    'expiresAt': Required[str],
+})
+RedditTrendingOutputVariant1Review.__pydantic_config__ = ConfigDict(extra="allow", strict=True)
+
+
 RedditTrendingOutputVariant1Totals = TypedDict('RedditTrendingOutputVariant1Totals', {
     'threads': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'upvotes': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
@@ -36,6 +46,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 +56,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)
 
@@ -58,7 +69,9 @@ RedditTrendingOutputVariant1RankedThreadsItem = TypedDict('RedditTrendingOutputV
     'commentCount': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'engagementScore': Required[Annotated[int, Field(ge=0, le=9007199254740991)]],
     'ageText': Required[str],
+    'postBody': NotRequired[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)]],
@@ -80,6 +93,7 @@ class RedditTrendingOutputVariant1(BaseModel):
 
     operation: Union[RedditTrendingOutputVariant1Operation, None] = Field(None, alias='operation', description='')
     topic: str = Field(..., alias='topic', description='')
+    review: Union[RedditTrendingOutputVariant1Review, None] = Field(None, alias='review', description='')
     subreddit: Union[str, None] = Field(..., alias='subreddit', description='')
     window: str = Field(..., alias='window', description='')
     totals: RedditTrendingOutputVariant1Totals = Field(..., alias='totals', description='')

{mcpscraper_sdk-0.57.2 → mcpscraper_sdk-0.57.4}/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):
@@ -1961,9 +1962,15 @@ class RedditThreadResponse(BaseModel):
     sourceUrl: str | None = None
 
 
+class ApprovalMode(Enum):
+    review = 'review'
+    approve = 'approve'
+    auto = 'auto'
+
+
 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'
@@ -1974,17 +1981,24 @@ class Window(Enum):
 
 
 class RedditTrendingRequest(BaseModel):
-    topic: str = Field(
-        ...,
-        description='Topic in plain words, e.g. "crm for small business". Not a URL.',
+    topic: str | None = Field(
+        None, description='Topic to search. Required for discovery.'
+    )
+    approvalMode: ApprovalMode | None = None
+    reviewId: UUID | None = Field(None, description='Required in approve mode.')
+    approvedUrls: list[str] | None = Field(
+        None,
+        description='Required in approve mode. Pass only URLs selected from the review.',
+        max_length=40,
+        min_length=1,
     )
     subreddit: str | None = Field(
         None,
         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 +2008,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,
@@ -2004,6 +2018,22 @@ class RedditTrendingRequest(BaseModel):
     )
 
 
+class Window1(Enum):
+    week = 'week'
+    field_14d = '14d'
+    month = 'month'
+    year = 'year'
+    all = 'all'
+
+
+class Review(BaseModel):
+    id: UUID
+    expiresAt: AwareDatetime
+    window: Window1 | None = None
+    includeComments: bool | None = None
+    maxCommentsPerThread: int | None = None
+
+
 class Totals(BaseModel):
     threads: int | None = None
     upvotes: int | None = None
@@ -2015,6 +2045,7 @@ class Comment1(BaseModel):
     score: str
     depth: int = Field(..., ge=0)
     body: str
+    publishedAt: AwareDatetime | None = None
 
 
 class Question(BaseModel):
@@ -2824,9 +2855,14 @@ class RankedThread(BaseModel):
     commentCount: int | None = None
     engagementScore: int | None = None
     ageText: str | None = None
+    postBody: str | None = None
     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
@@ -2840,6 +2876,7 @@ class RankedThread(BaseModel):
 
 class RedditTrendingResponse(BaseModel):
     topic: str | None = None
+    review: Review | None = None
     subreddit: str | None = None
     window: str | None = Field(
         None,
@@ -2855,7 +2892,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