firecrawl 4.3.4__tar.gz → 4.3.5__tar.gz

{firecrawl-4.3.4 → firecrawl-4.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firecrawl
-Version: 4.3.4
+Version: 4.3.5
 Summary: Python SDK for Firecrawl API
 Home-page: https://github.com/firecrawl/firecrawl
 Author: Mendable.ai

{firecrawl-4.3.4 → firecrawl-4.3.5}/firecrawl/__init__.py

@@ -17,7 +17,7 @@ from .v1 import (
     V1ChangeTrackingOptions,
 )
 
-__version__ = "4.3.4"
+__version__ = "4.3.5"
 
 # Define the logger for the Firecrawl project
 logger: logging.Logger = logging.getLogger("firecrawl")

{firecrawl-4.3.4 → firecrawl-4.3.5}/firecrawl/types.py

@@ -82,6 +82,7 @@ from .v2.types import (
     
     # Configuration types
     ClientConfig,
+    AgentOptions,
 )
 
 __all__ = [
@@ -162,4 +163,5 @@ __all__ = [
     
     # Configuration types
     'ClientConfig',
+    'AgentOptions',
 ]  

{firecrawl-4.3.4 → firecrawl-4.3.5}/firecrawl/v2/client.py

@@ -37,6 +37,7 @@ from .types import (
     PDFAction,
     Location,
     PaginationConfig,
+    AgentOptions,
 )
 from .utils.http_client import HttpClient
 from .utils.error_handler import FirecrawlError
@@ -495,6 +496,7 @@ class FirecrawlClient:
         scrape_options: Optional['ScrapeOptions'] = None,
         ignore_invalid_urls: Optional[bool] = None,
         integration: Optional[str] = None,
+        agent: Optional[AgentOptions] = None,
     ):
         """Start an extract job (non-blocking).
 
@@ -508,7 +510,8 @@ class FirecrawlClient:
             show_sources: Include per-field/source mapping when available
             scrape_options: Scrape options applied prior to extraction
             ignore_invalid_urls: Skip invalid URLs instead of failing
-
+            integration: Integration tag/name
+            agent: Agent configuration
         Returns:
             Response payload with job id/status (poll with get_extract_status)
         """
@@ -524,6 +527,7 @@ class FirecrawlClient:
             scrape_options=scrape_options,
             ignore_invalid_urls=ignore_invalid_urls,
             integration=integration,
+            agent=agent,
         )
 
     def extract(
@@ -541,6 +545,7 @@ class FirecrawlClient:
         poll_interval: int = 2,
         timeout: Optional[int] = None,
         integration: Optional[str] = None,
+        agent: Optional[AgentOptions] = None,
     ):
         """Extract structured data and wait until completion.
 
@@ -556,7 +561,8 @@ class FirecrawlClient:
             ignore_invalid_urls: Skip invalid URLs instead of failing
             poll_interval: Seconds between status checks
             timeout: Maximum seconds to wait (None for no timeout)
-
+            integration: Integration tag/name
+            agent: Agent configuration
         Returns:
             Final extract response when completed
         """
@@ -574,6 +580,7 @@ class FirecrawlClient:
             poll_interval=poll_interval,
             timeout=timeout,
             integration=integration,
+            agent=agent,
         )
 
     def start_batch_scrape(

{firecrawl-4.3.4 → firecrawl-4.3.5}/firecrawl/v2/methods/extract.py

@@ -2,6 +2,7 @@ from typing import Any, Dict, List, Optional
 import time
 
 from ..types import ExtractResponse, ScrapeOptions
+from ..types import AgentOptions
 from ..utils.http_client import HttpClient
 from ..utils.validation import prepare_scrape_options
 from ..utils.error_handler import handle_response_error
@@ -19,6 +20,7 @@ def _prepare_extract_request(
     scrape_options: Optional[ScrapeOptions] = None,
     ignore_invalid_urls: Optional[bool] = None,
     integration: Optional[str] = None,
+    agent: Optional[AgentOptions] = None,
 ) -> Dict[str, Any]:
     body: Dict[str, Any] = {}
     if urls is not None:
@@ -43,6 +45,11 @@ def _prepare_extract_request(
             body["scrapeOptions"] = prepared
     if integration is not None and str(integration).strip():
         body["integration"] = str(integration).strip()
+    if agent is not None:
+        try:
+            body["agent"] = agent.model_dump(exclude_none=True)  # type: ignore[attr-defined]
+        except AttributeError:
+            body["agent"] = agent  # fallback
     return body
 
 
@@ -59,6 +66,7 @@ def start_extract(
     scrape_options: Optional[ScrapeOptions] = None,
     ignore_invalid_urls: Optional[bool] = None,
     integration: Optional[str] = None,
+    agent: Optional[AgentOptions] = None,
 ) -> ExtractResponse:
     body = _prepare_extract_request(
         urls,
@@ -71,6 +79,7 @@ def start_extract(
         scrape_options=scrape_options,
         ignore_invalid_urls=ignore_invalid_urls,
         integration=integration,
+        agent=agent,
     )
     resp = client.post("/v2/extract", body)
     if not resp.ok:
@@ -117,6 +126,7 @@ def extract(
     poll_interval: int = 2,
     timeout: Optional[int] = None,
     integration: Optional[str] = None,
+    agent: Optional[AgentOptions] = None,
 ) -> ExtractResponse:
     started = start_extract(
         client,
@@ -130,9 +140,9 @@ def extract(
         scrape_options=scrape_options,
         ignore_invalid_urls=ignore_invalid_urls,
         integration=integration,
+        agent=agent,
     )
     job_id = getattr(started, "id", None)
     if not job_id:
         return started
-    return wait_extract(client, job_id, poll_interval=poll_interval, timeout=timeout)
-
+    return wait_extract(client, job_id, poll_interval=poll_interval, timeout=timeout)

{firecrawl-4.3.4 → firecrawl-4.3.5}/firecrawl/v2/types.py

@@ -114,6 +114,10 @@ class DocumentMetadata(BaseModel):
     def coerce_status_code_to_int(cls, v):
         return cls._coerce_string_to_int(v)
 
+class AgentOptions(BaseModel):
+    """Configuration for the agent in extract operations."""
+    model: Literal["FIRE-1"] = "FIRE-1"
+
 class AttributeResult(BaseModel):
     """Result of attribute extraction."""
     selector: str
@@ -497,6 +501,7 @@ class ExtractRequest(BaseModel):
     scrape_options: Optional[ScrapeOptions] = None
     ignore_invalid_urls: Optional[bool] = None
     integration: Optional[str] = None
+    agent: Optional[AgentOptions] = None
     
 class ExtractResponse(BaseModel):
     """Response for extract operations (start/status/final)."""

{firecrawl-4.3.4 → firecrawl-4.3.5}/firecrawl.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firecrawl
-Version: 4.3.4
+Version: 4.3.5
 Summary: Python SDK for Firecrawl API
 Home-page: https://github.com/firecrawl/firecrawl
 Author: Mendable.ai