# Firecrawl developer index search

Needs query.

Search the developer index

- Tool ID: `firecrawl/developer-search`
- Name in the catalog: Search the developer index
- Provider: [Firecrawl](/providers/firecrawl.md)
- Capability: [GitHub, npm & PyPI](/tools/developer-data/code.md)
- Price: price pending
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

No price is recorded for this tool yet.


```json
{
  "model": "reported",
  "costPath": "",
  "requireCost": true,
  "maxUsdDefault": 0,
  "maxUsdCap": 0,
  "headroom": 1
}
```

Pricing source: [https://docs.firecrawl.dev/billing](https://docs.firecrawl.dev/billing). Standard monthly allowance $100/100,000 = $0.001/credit; marginal Standard overage $5/2,000 = $0.0025/credit. Gateway uses marginal cost; no automatic reload changed..

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Natural-language question or search phrase."
    },
    "k": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 10,
      "description": "Number of ranked results to return."
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "doc",
          "issue",
          "pull_request",
          "readme"
        ]
      },
      "description": "Result kinds to search. Defaults to all four. Accepts a repeated parameter (`types=issue&types=pull_request`) or one comma-separated value (`types=issue,pull_request`)."
    },
    "repos": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Repository slugs to scope the repository half of the index to, such as `firecrawl/firecrawl`. Applies to the `issue`, `pull_request`, and `readme` types only. Sent together with `sources`, the two halves are combined rather than intersected, so matching results come back from either. Returns 400 when no repository type is in `types`, reporting that `repos` cannot match any requested type and that you should add repository types or drop `repos`."
    },
    "sources": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 512
      },
      "description": "Documentation source ids to scope the documentation half to, at most 20. Applies to the `doc` type only. Not a fixed enum: ids reflect the documentation sites in the index and the set grows over time, so confirm an id resolves by sending it and reading the `sources` array on the response. Returns 400 with `sources cannot match any requested type; add doc or drop sources` when `doc` is not in `types`."
    },
    "skills": {
      "type": "string",
      "enum": [
        "only"
      ],
      "description": "Set to `only` to limit the search to indexed agent-skill files."
    },
    "passages": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "default": 1,
      "description": "Matched passages to return per result."
    },
    "language": {
      "type": "string",
      "description": "Repository primary language, such as `Rust`. Applies to repository results only; sending it with no `sources` scope returns no `doc` results. See [how the repository filters scope a search](/api-reference/endpoint/developer-search#how-the-repository-filters-scope-a-search)."
    },
    "topic": {
      "type": "string",
      "description": "Repository topic, such as `async`. Applies to repository results only; sending it with no `sources` scope returns no `doc` results."
    },
    "license": {
      "type": "string",
      "description": "Repository license, such as `MIT`. Applies to repository results only; sending it with no `sources` scope returns no `doc` results."
    },
    "min_stars": {
      "type": "integer",
      "minimum": 0,
      "description": "Lower bound on repository stars. Applies to repository results only; sending it with no `sources` scope returns no `doc` results."
    },
    "max_stars": {
      "type": "integer",
      "minimum": 0,
      "description": "Upper bound on repository stars. Applies to repository results only; sending it with no `sources` scope returns no `doc` results."
    },
    "archived": {
      "type": "boolean",
      "description": "Include or exclude archived repositories. Applies to repository results only; sending it with no `sources` scope returns no `doc` results."
    },
    "fork": {
      "type": "boolean",
      "description": "Include or exclude forks. Applies to repository results only; sending it with no `sources` scope returns no `doc` results."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}
```

## Published example

No example input is published for this tool. Ask for the inputs required by its schema.

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://docs.firecrawl.dev/api-reference/v2-introduction)

[REST inspection](https://api.agentik.cc/v1/tools/firecrawl/developer-search) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/firecrawl/developer-search) · [Agent index](/llms.txt)