Alexandria

Alexandria donne aux agents accès à des données structurées via Firecrawl. Découvrez un outil, inspectez ses entrées, puis exécutez-le. La découverte est gratuite ; l’exécution consomme les crédits indiqués sur l’outil. Parcourir les providers · Gérer les conditions des providers

Conçu pour les agents

Installez le CLI ou connectez le serveur MCP.

CLI Firecrawl
MCP

# Trouvez des outils en plus des résultats web.
firecrawl search "podcast conversations about AI agents" --sources web,alexandria --domain-tools --limit 2

# Inspectez les entrées et la tarification.
firecrawl find-tools --providers particle --level tools --expand options,response

# Exécutez l'outil.
firecrawl scrape particle/podcasts/episodes/search --options '{"keyword_search":"AI agents","limit":2}'

Installez-le avec npm install -g firecrawl-cli et connectez-vous avec firecrawl login.

Demandez à votre agent : « Trouve les outils de podcast de Particle, inspecte les entrées et la tarification de la recherche d’épisodes, puis trouve des conversations sur les agents IA. »L’agent utilise firecrawl_search pour découvrir les outils, firecrawl_find_tools pour les inspecter et firecrawl_scrape pour les exécuter.

Utiliser Alexandria depuis les SDK et l’API

Trouver le bon outil

Décrivez votre besoin. Alexandria renvoie les outils pertinents en plus de vos résultats web.

const result = await firecrawl.search(
  "podcast conversations about AI agents",
  {
    sources: ["web", "alexandria"],
    limit: 2,
  },
);

result = firecrawl.search(
    "podcast conversations about AI agents",
    sources=["web", "alexandria"],
    limit=2,
)

curl https://api.firecrawl.dev/v2/search \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "podcast conversations about AI agents",
  "sources": [
    "web",
    "alexandria"
  ],
  "limit": 2
}'

Les résultats contiennent des pages web et des tools classés par pertinence. Chaque outil précise son provider, sa fonctionnalité, ses entrées, son contrat de response et son prix.

Vérifier ce dont il a besoin

Consultez les options, la response et le prix d’exécution de l’outil sélectionné avant de l’appeler. Voir Find Tools pour plus de détails.

Obtenir les données

Utilisez scrape pour appeler l’outil avec les entrées définies dans son contrat. Indiquez le provider et la fonctionnalité sous alexandria ; aucune URL de page n’est nécessaire.

const episodes = await firecrawl.scrape({
  alexandria: {
    provider: "particle",
    capability: "podcasts/episodes/search",
    options: {
      semantic_search: "AI agents",
      limit: 2,
    },
  },
});

console.log(episodes.alexandria[0].data);

episodes = firecrawl.scrape(
    alexandria={
        "provider": "particle",
        "capability": "podcasts/episodes/search",
        "options": {
            "semantic_search": "AI agents",
            "limit": 2,
        },
    },
)

print(episodes.alexandria[0].data)

REQUEST_ID="$(uuidgen)"

curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-request-id: $REQUEST_ID" \
  -d '{
  "alexandria": {
    "provider": "particle",
    "capability": "podcasts/episodes/search",
    "options": {
      "semantic_search": "AI agents",
      "limit": 2
    }
  }
}'

Lisez le résultat dans episodes.alexandria[0].data. Vérifiez la présence d’erreurs dans chaque résultat d’outil avant d’en exploiter les données. Les réponses HTTP brutes encapsulent le résultat du SDK dans data.

Find Tools

Utilisez findTools / find_tools pour parcourir les providers et inspecter leurs outils gratuitement. Suivez la requête next d’un élément pour obtenir plus de détails ; le next de premier niveau pagine le catalogue.

const catalogue = await firecrawl.findTools({
  providers: ["particle"],
  limit: 2,
});

// Chaque requête next dévoile une autre partie du catalogue.
const next = catalogue.items[0]?.next;
if (next) {
  const details = await firecrawl.scrape({ alexandria: next });
  console.log(details.alexandria[0].data);
}

catalogue = firecrawl.find_tools(providers=["particle"], limit=2)

if catalogue.items and catalogue.items[0].get("next"):
    details = firecrawl.scrape(alexandria=catalogue.items[0]["next"])
    print(details.alexandria[0].data)

Utilisation depuis Agent

Les exécutions d’Agent peuvent appeler d’elles-mêmes les providers de votre équipe au cours de leurs recherches. Envoyez exchange: { "enabled": true } avec la requête et, si vous le souhaitez, épinglez jusqu’à cinq providers avec toolkits. Sans exchange, une exécution lancée via l’API ou un SDK s’appuie uniquement sur le web. Consultez Utiliser vos outils Alexandria connectés.

Tarification et accès

Découverte des outils : gratuite. Utilisez sources: ["alexandria"] pour les outils uniquement, ou ["web", "alexandria"] pour inclure les résultats web payants.
Exécution : facturée au prix indiqué de l’outil.
Conditions du provider : une erreur THIRD_PARTY_DATA_TERMS_REQUIRED contient requiresAction.url. Un administrateur de l’organisation doit y consulter et accepter les conditions. Les agents doivent obtenir une autorisation explicite de l’utilisateur avant d’accepter ces conditions. Les exécutions d’Agent ignorent les providers dont votre équipe n’a pas accepté les conditions et les signalent dans exchange.skippedProviders.

Trouver des outils pour un site web

Ajoutez domainTools: true à une recherche ou à un scrape d’URL classique pour inclure les outils associés au site web. La mise en correspondance est gratuite ; la recherche web ou le scrape de page est facturé normalement. Les résultats incluent matchedBy et matchedUrls.La recherche active la correspondance par domaine par défaut lorsque sources inclut alexandria ; définissez domainTools: false pour la désactiver. Pour les scrapes d’URL, la correspondance par domaine est désactivée par défaut.

Retours

Signalez des problèmes ou demandez de nouvelles fonctionnalités avec firecrawl alexandria feedback, ou via l’outil MCP firecrawl_feedback avec endpoint: "alexandria". Exécutez firecrawl alexandria feedback --help pour afficher les options disponibles. Les retours Alexandria doivent être envoyés dans les 20 minutes qui suivent la dernière recherche, découverte ou exécution Alexandria de votre équipe. Chaque appel Alexandria relance ce délai ; passé ce délai, tout retour est rejeté avec FEEDBACK_WINDOW_EXPIRED. Chaque retour donne lieu au remboursement de 1 crédit, quelle que soit la note attribuée. Les remboursements sont plafonnés, par jour UTC, à 10 crédits par site web et à 100 crédits par équipe. Une fois l’un de ces plafonds atteint, le retour est tout de même enregistré, mais sans remboursement ; la réponse renvoie websiteCapReached: true lorsque le plafond du site web concerné est atteint, et dailyCapReached: true lorsque celui de l’équipe est atteint.

Prime : 5 000 crédits à gagner pour un retour de qualité sur Alexandria

Pour être éligible, réalisez un entretien riche et utile (réfléchi, avec des cas d’utilisation concrets, etc.) avec notre assistant de retours Firecrawl. Cela ne prend que quelques minutes, vous pouvez l’interrompre à tout moment, et il convient aussi bien aux humains qu’aux agents (collez simplement le lien dans votre harnais agentique !). Vous n’avez pas encore utilisé Alexandria ? Votre avis compte quand même.

Démarrer l’entretien

Indiquez votre e-mail pour être éligible. La qualité des entretiens est évaluée à la fin de chaque semaine.

Prise en main

Points de terminaison de base

Plus

Démarrages rapides

Guides développeur

Webhooks

Cas d'utilisation

Autres

Contribuer

Conçu pour les agents

Utiliser Alexandria depuis les SDK et l’API

Find Tools

Utilisation depuis Agent

Tarification et accès

Retours

​Conçu pour les agents

​Utiliser Alexandria depuis les SDK et l’API

​Find Tools

​Utilisation depuis Agent

​Tarification et accès

​Retours

Conçu pour les agents

Utiliser Alexandria depuis les SDK et l’API

Find Tools

Utilisation depuis Agent

Tarification et accès

Retours