Skip to content

Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥

feat(api): a/mc

Gergő Móricz6a2425b7765e
diff --git a/apps/api/src/controllers/v2/agent.ts b/apps/api/src/controllers/v2/agent.ts
index 0b8ca65cf..ed40e1f4d 100644
--- a/apps/api/src/controllers/v2/agent.ts
+++ b/apps/api/src/controllers/v2/agent.ts
@@ -107,6 +107,7 @@ export async function agentController(
apiKeyId: req.acuc!.api_key_id ?? undefined,
teamId: req.auth.team_id,
isFreeRequest,
+ maxCredits: req.body.maxCredits ?? undefined,
}),
},
);
diff --git a/apps/api/src/controllers/v2/types.ts b/apps/api/src/controllers/v2/types.ts
index 705689ace..309be69e9 100644
--- a/apps/api/src/controllers/v2/types.ts
+++ b/apps/api/src/controllers/v2/types.ts
@@ -730,6 +730,7 @@ export const agentRequestSchema = z.strictObject({
),
origin: z.string().optional().prefault("api"),
integration: integrationSchema.optional().transform(val => val || null),
+ maxCredits: z.number().optional(),
overrideWhitelist: z.string().optional(),
});
diff --git a/apps/js-sdk/firecrawl/package.json b/apps/js-sdk/firecrawl/package.json
index 708ed29aa..4f8fd8ec3 100644
--- a/apps/js-sdk/firecrawl/package.json
+++ b/apps/js-sdk/firecrawl/package.json
@@ -1,6 +1,6 @@
{
"name": "@mendable/firecrawl-js",
- "version": "4.9.1",
+ "version": "4.9.2",
"description": "JavaScript SDK for Firecrawl API",
"main": "dist/index.js",
"types": "dist/index.d.ts",
diff --git a/apps/js-sdk/firecrawl/src/v2/methods/agent.ts b/apps/js-sdk/firecrawl/src/v2/methods/agent.ts
index 0f22206ff..0b32a1e42 100644
--- a/apps/js-sdk/firecrawl/src/v2/methods/agent.ts
+++ b/apps/js-sdk/firecrawl/src/v2/methods/agent.ts
@@ -9,6 +9,7 @@ function prepareAgentPayload(args: {
prompt: string;
schema?: Record<string, unknown> | ZodTypeAny;
integration?: string;
+ maxCredits?: number;
}): Record<string, unknown> {
const body: Record<string, unknown> = {};
if (args.urls) body.urls = args.urls;
@@ -19,6 +20,7 @@ function prepareAgentPayload(args: {
body.schema = isZod ? zodToJsonSchema(s) : args.schema;
}
if (args.integration && args.integration.trim()) body.integration = args.integration.trim();
+ if (args.maxCredits !== null && args.maxCredits !== undefined) body.maxCredits = args.maxCredits;
return body;
}
diff --git a/apps/python-sdk/firecrawl/__init__.py b/apps/python-sdk/firecrawl/__init__.py
index cfd581b94..82aa88172 100644
--- a/apps/python-sdk/firecrawl/__init__.py
+++ b/apps/python-sdk/firecrawl/__init__.py
@@ -17,7 +17,7 @@ from .v1 import (
V1ChangeTrackingOptions,
)
-__version__ = "4.11.1"
+__version__ = "4.11.2"
# Define the logger for the Firecrawl project
logger: logging.Logger = logging.getLogger("firecrawl")
diff --git a/apps/python-sdk/firecrawl/v2/client.py b/apps/python-sdk/firecrawl/v2/client.py
index 243b72c1c..d911bbc21 100644
--- a/apps/python-sdk/firecrawl/v2/client.py
+++ b/apps/python-sdk/firecrawl/v2/client.py
@@ -770,6 +770,7 @@ class FirecrawlClient:
prompt: Natural-language instruction for the agent
schema: Target JSON schema for the output
integration: Integration tag/name
+ max_credits: Maximum credits to use (optional)
Returns:
Response payload with job id/status (poll with get_agent_status)
"""
@@ -779,6 +780,7 @@ class FirecrawlClient:
prompt=prompt,
schema=schema,
integration=integration,
+ max_credits=max_credits,
)
def agent(
@@ -790,6 +792,7 @@ class FirecrawlClient:
integration: Optional[str] = None,
poll_interval: int = 2,
timeout: Optional[int] = None,
+ max_credits: Optional[int] = None,
):
"""Run an agent and wait until completion.
@@ -800,6 +803,7 @@ class FirecrawlClient:
integration: Integration tag/name
poll_interval: Seconds between status checks
timeout: Maximum seconds to wait (None for no timeout)
+ max_credits: Maximum credits to use (optional)
Returns:
Final agent response when completed
"""
@@ -811,6 +815,7 @@ class FirecrawlClient:
integration=integration,
poll_interval=poll_interval,
timeout=timeout,
+ max_credits=max_credits,
)
def get_agent_status(self, job_id: str):
diff --git a/apps/python-sdk/firecrawl/v2/client_async.py b/apps/python-sdk/firecrawl/v2/client_async.py
index 6b7468cd5..6e8170e5d 100644
--- a/apps/python-sdk/firecrawl/v2/client_async.py
+++ b/apps/python-sdk/firecrawl/v2/client_async.py
@@ -321,6 +321,7 @@ class AsyncFirecrawlClient:
integration: Optional[str] = None,
poll_interval: int = 2,
timeout: Optional[int] = None,
+ max_credits: Optional[int] = None,
):
return await async_agent.agent(
self.async_http_client,
@@ -330,6 +331,7 @@ class AsyncFirecrawlClient:
integration=integration,
poll_interval=poll_interval,
timeout=timeout,
+ max_credits=max_credits,
)
async def get_agent_status(self, job_id: str):
@@ -342,6 +344,7 @@ class AsyncFirecrawlClient:
prompt: str,
schema: Optional[Dict[str, Any]] = None,
integration: Optional[str] = None,
+ max_credits: Optional[int] = None,
):
return await async_agent.start_agent(
self.async_http_client,
@@ -349,6 +352,7 @@ class AsyncFirecrawlClient:
prompt=prompt,
schema=schema,
integration=integration,
+ max_credits=max_credits,
)
async def cancel_agent(self, job_id: str) -> bool:
diff --git a/apps/python-sdk/firecrawl/v2/methods/agent.py b/apps/python-sdk/firecrawl/v2/methods/agent.py
index a143d6b1e..b8fbc3f9b 100644
--- a/apps/python-sdk/firecrawl/v2/methods/agent.py
+++ b/apps/python-sdk/firecrawl/v2/methods/agent.py
@@ -12,6 +12,7 @@ def _prepare_agent_request(
prompt: str,
schema: Optional[Dict[str, Any]] = None,
integration: Optional[str] = None,
+ max_credits: Optional[int] = None,
) -> Dict[str, Any]:
body: Dict[str, Any] = {}
if urls is not None:
@@ -21,6 +22,8 @@ def _prepare_agent_request(
body["schema"] = schema
if integration is not None and str(integration).strip():
body["integration"] = str(integration).strip()
+ if max_credits is not None and max_credits > 0:
+ body["maxCredits"] = max_credits
return body
@@ -40,12 +43,14 @@ def start_agent(
prompt: str,
schema: Optional[Dict[str, Any]] = None,
integration: Optional[str] = None,
+ max_credits: Optional[int] = None,
) -> AgentResponse:
body = _prepare_agent_request(
urls,
prompt=prompt,
schema=schema,
integration=integration,
+ max_credits=max_credits,
)
resp = client.post("/v2/agent", body)
if not resp.ok:
@@ -88,6 +93,7 @@ def agent(
integration: Optional[str] = None,
poll_interval: int = 2,
timeout: Optional[int] = None,
+ max_credits: Optional[int] = None,
) -> AgentResponse:
started = start_agent(
client,
@@ -95,6 +101,7 @@ def agent(
prompt=prompt,
schema=schema,
integration=integration,
+ max_credits=max_credits,
)
job_id = getattr(started, "id", None)
if not job_id:
diff --git a/apps/python-sdk/firecrawl/v2/methods/aio/agent.py b/apps/python-sdk/firecrawl/v2/methods/aio/agent.py
index 289b1f52f..25ec634d8 100644
--- a/apps/python-sdk/firecrawl/v2/methods/aio/agent.py
+++ b/apps/python-sdk/firecrawl/v2/methods/aio/agent.py
@@ -11,6 +11,7 @@ def _prepare_agent_request(
prompt: str,
schema: Optional[Dict[str, Any]] = None,
integration: Optional[str] = None,
+ max_credits: Optional[int] = None,
) -> Dict[str, Any]:
body: Dict[str, Any] = {}
if urls is not None:
@@ -20,6 +21,8 @@ def _prepare_agent_request(
body["schema"] = schema
if integration is not None and str(integration).strip():
body["integration"] = str(integration).strip()
+ if max_credits is not None and max_credits > 0:
+ body["maxCredits"] = max_credits
return body
@@ -39,12 +42,14 @@ async def start_agent(
prompt: str,
schema: Optional[Dict[str, Any]] = None,
integration: Optional[str] = None,
+ max_credits: Optional[int] = None,
) -> AgentResponse:
body = _prepare_agent_request(
urls,
prompt=prompt,
schema=schema,
integration=integration,
+ max_credits=max_credits,
)
resp = await client.post("/v2/agent", body)
payload = _normalize_agent_response_payload(resp.json())
@@ -83,6 +88,7 @@ async def agent(
integration: Optional[str] = None,
poll_interval: int = 2,
timeout: Optional[int] = None,
+ max_credits: Optional[int] = None,
) -> AgentResponse:
started = await start_agent(
client,
@@ -90,6 +96,7 @@ async def agent(
prompt=prompt,
schema=schema,
integration=integration,
+ max_credits=max_credits,
)
job_id = getattr(started, "id", None)
if not job_id: