---
type: "firecrawl-provider"
description: "Search developer documentation, repositories, issues and agent skills with matched passages."
use_when: "Find developer sources and passages."
categories: "Developer"
capabilities: 1
credits_per_record: 2
---
# Developer Index on Firecrawl Alexandria

Search developer documentation, repositories, issues and agent skills with matched passages.

- Categories: Developer
- Category index: [Developer category](https://firecrawl.dev/alexandria/agents/categories/developer)
- Provider key: `firecrawl-developer-index`
- Access: Firecrawl credits
- Cost (Search developer sources): 2 credits / 10 results

## More

- [Human guide](https://firecrawl.dev/app/alexandria/firecrawl-developer-index)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/firecrawl-developer-index/openapi.json)

## 1. Choose this provider when

Find developer sources and passages.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "firecrawl-developer-index",
  "capability": "search",
  "options": {
    "query": "<query>",
    "k": 10
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `query` (string, required): Question or search phrase. Example: `<query>`
- `k` (number): Maximum results to return. Example: `10`
- `types` (string[]): Filter by types; sent as repeated query parameters. Example: `[]`
- `repos` (string[]): Filter by repos; sent as repeated query parameters. Example: `[]`
- `sources` (string[]): Filter by sources; sent as repeated query parameters. Example: `[]`
- `topic` (string[]): Filter by topic; sent as repeated query parameters. Example: `[]`
- `language` (string): Filter by language. Example: `<language>`
- `license` (string): Filter by license. Example: `<license>`
- `min_stars` (number): Repository min stars. Example: `10`
- `max_stars` (number): Repository max stars. Example: `10`
- `archived` (boolean): Filter repositories by archived status. Example: `false`
- `fork` (boolean): Filter repositories by fork status. Example: `false`
- `passages` (number): Matched passages per result. Example: `5`
- `skills` (string): Return only agent-skill files. Example: `only`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "firecrawl-developer-index",
    capability: "search",
    options: {
      query: "<query>",
      k: 10,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "firecrawl-developer-index",
  "capability": "search",
  "options": {
    "query": "<query>",
    "k": 10
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "firecrawl-developer-index",
    "capability": "search",
    "options": {
      "query": "<query>",
      "k": 10
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'firecrawl-developer-index/search' \
  --options '{"query":"<query>","k":10}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "firecrawl-developer-index",
  "capability": "search",
  "options": {
    "query": "<query>",
    "k": 10
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "firecrawl-developer-index",
  "capability": "search",
  "options": {
    "query": "<query>",
    "k": 10
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "results": [
    {
      "url": "<url>",
      "title": "<title>",
      "passages": []
    }
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Search developer sources

- Capability: `search`
- Description: Ranked sources with passages. The complete upstream envelope, including partial results and filter status, is preserved.
- Instructions: Find code examples, official documentation, repository discussions or agent skills for a development task.
- Cost: 2 credits / 10 results
- Capability file: [Search developer sources](https://firecrawl.dev/alexandria/agents/providers/firecrawl-developer-index/search)

Accepted options:
- `query` (string, required): Question or search phrase. Example: `<query>`
- `k` (number): Maximum results to return. Example: `10`
- `types` (string[]): Filter by types; sent as repeated query parameters. Example: `[]`
- `repos` (string[]): Filter by repos; sent as repeated query parameters. Example: `[]`
- `sources` (string[]): Filter by sources; sent as repeated query parameters. Example: `[]`
- `topic` (string[]): Filter by topic; sent as repeated query parameters. Example: `[]`
- `language` (string): Filter by language. Example: `<language>`
- `license` (string): Filter by license. Example: `<license>`
- `min_stars` (number): Repository min stars. Example: `10`
- `max_stars` (number): Repository max stars. Example: `10`
- `archived` (boolean): Filter repositories by archived status. Example: `false`
- `fork` (boolean): Filter repositories by fork status. Example: `false`
- `passages` (number): Matched passages per result. Example: `5`
- `skills` (string): Return only agent-skill files. Example: `only`

Response schema example:
```json
{
  "results": [
    {
      "url": "<url>",
      "title": "<title>",
      "passages": []
    }
  ]
}
```