Preguntar

Diagnostica problemas de Firecrawl con un agente de soporte con IA

curl --request POST \
  --url https://api.firecrawl.dev/v2/support/ask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "rationale": "<string>",
  "jobId": "<string>",
  "context": {}
}
'

import requests

url = "https://api.firecrawl.dev/v2/support/ask"

payload = {
    "question": "<string>",
    "rationale": "<string>",
    "jobId": "<string>",
    "context": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({question: '<string>', rationale: '<string>', jobId: '<string>', context: {}})
};

fetch('https://api.firecrawl.dev/v2/support/ask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/support/ask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'question' => '<string>',
    'rationale' => '<string>',
    'jobId' => '<string>',
    'context' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/support/ask"

	payload := strings.NewReader("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v2/support/ask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/support/ask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

POST

support

ask

Diagnostica problemas de Firecrawl con un agente de soporte con IA

curl --request POST \
  --url https://api.firecrawl.dev/v2/support/ask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "rationale": "<string>",
  "jobId": "<string>",
  "context": {}
}
'

import requests

url = "https://api.firecrawl.dev/v2/support/ask"

payload = {
    "question": "<string>",
    "rationale": "<string>",
    "jobId": "<string>",
    "context": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({question: '<string>', rationale: '<string>', jobId: '<string>', context: {}})
};

fetch('https://api.firecrawl.dev/v2/support/ask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/support/ask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'question' => '<string>',
    'rationale' => '<string>',
    'jobId' => '<string>',
    'context' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/support/ask"

	payload := strings.NewReader("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v2/support/ask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/support/ask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

El endpoint /support/ask es un agente de soporte con IA que diagnostica problemas con tus trabajos de Firecrawl, tu cuenta y el uso de la API. Envía una pregunta y recibe una respuesta verificada con parámetros concretos para corregirlos, normalmente en 15–30 segundos.

Diseñado para agentes de IA

/support/ask está diseñado para la comunicación entre agentes. Si estás creando un agente de IA que usa Firecrawl, integra este endpoint en tu flujo de gestión de errores para que tu agente pueda diagnosticar por sí mismo fallos de scraping, problemas de crawl y problemas de configuración sin intervención de una persona. Incluye un campo rationale para darle al agente de soporte contexto sobre lo que tu usuario final quiere lograr. Esto ayuda a priorizar la recopilación de evidencias.

Cómo funciona

Describes el problema — una pregunta en lenguaje natural que describe la incidencia.
El agente investiga — inspecciona los registros del trabajo, el estado de la cuenta, la documentación y el código fuente.
El agente valida — cuando es posible, el agente prueba una corrección con la API real de Firecrawl (p. ej., reintentando un scrape con parámetros ajustados).
Obtienes una respuesta verificada — la respuesta incluye una answer en prosa, fixParameters en formato legible por máquina que puedes aplicar directamente y resultados de validation que muestran si se probó la corrección.

Autenticación

Usa tu clave de API de Firecrawl como token Bearer. La solicitud se restringe automáticamente a tu equipo: solo puedes consultar tus propios trabajos y los datos de tu cuenta.

curl -X POST https://api.firecrawl.dev/v2/support/ask \
  -H "Authorization: Bearer fc-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "my crawl returned 3 pages but I expected 50",
    "rationale": "user is on their third failed crawl attempt today"
  }'

Campos de la respuesta

Campo	Tipo	Descripción
`answer`	string	Texto de 2 a 4 frases que describe el diagnóstico y la solución
`confidence`	string	`high`, `medium` o `low`
`fixParameters`	object	null	Parámetros de la API para aplicar la corrección (p. ej., `{"waitFor": 5000}`)
`validation`	object	null	Indica si se probó la corrección: `tested`, `result` (éxito/fallo/omitido), `evidence`
`feedback`	object	null	Presente cuando el agente se queda bloqueado; `{ blockedBy, attempted }`. Null en caso de éxito.
`durationMs`	integer	Tiempo total de ejecución en milisegundos

Códigos de estado

Código	Significado
`200`	Respondida o atascada (siempre se devuelve el sobre)
`400`	JSON no válido o no cumple el esquema
`401`	Falta el token Bearer o no es válido
`504`	Se alcanzó el límite estricto de 60 s — se devolvió un sobre parcial

Para consultar la guía de la función con ejemplos de integración, consulta la documentación de la función Ask.

¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para ver las instrucciones de onboarding automatizado.

Autorizaciones

Authorization

string

header

requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cuerpo

application/json

question

string

requerido

Qué diagnosticar. Describe el problema que estás experimentando.

Required string length: 1 - 8000

rationale

string

Recomendado para agentes de IA que realizan llamadas. 1-2 frases sobre lo que el usuario final intenta lograr.

Required string length: 1 - 2000

jobId

string

ID de trabajo opcional de Firecrawl con el que se asoció la llamada fallida. Herramientas como debugJob, searchLogs y getJob usan este valor de forma predeterminada cuando se establece, por lo que el agente no necesita extraerlo de la pregunta.

context

object

Metadatos de formato libre del agente que realiza la llamada, convertidos en string dentro del prompt de diagnóstico.

Respuesta

Diagnóstico completado. El contenedor se devuelve tanto si el agente encontró una respuesta como si se quedó atascado.

requestId

string

Identificador único de esta solicitud.

answer

string

Texto de 2 a 4 frases que explica qué falla y cómo corregirlo.

confidence

enum<string>

Nivel de confianza del agente en el diagnóstico.

Opciones disponibles:

high,

medium,

low

fixParameters

object | null

Parámetros de API accionables por máquina para aplicar la corrección recomendada. Null si no corresponde ninguna corrección.

validation

object | null

Indica si el agente probó la corrección en la API activa de Firecrawl.

Show child attributes

feedback

object | null

Presente cuando el agente se queda atascado y no puede generar una respuesta útil. Null en caso de éxito.

Show child attributes

durationMs

integer

Tiempo total de ejecución en milisegundos.

Uso de la API

Endpoints de búsqueda

Endpoints de scraping

Endpoints de Interact

Endpoints de mapeo

Endpoints de parseo

Endpoints de rastreo

Endpoints de depuración agéntica

Endpoints de cuenta

Cargas útiles de Webhook

Integración para partners

Diseñado para agentes de IA

Cómo funciona

Autenticación

Campos de la respuesta

Códigos de estado

Autorizaciones

Cuerpo

Respuesta

​Diseñado para agentes de IA

​Cómo funciona

​Autenticación

​Campos de la respuesta

​Códigos de estado

Autorizaciones

Cuerpo

Respuesta

Diseñado para agentes de IA

Cómo funciona

Autenticación

Campos de la respuesta

Códigos de estado