# SDK и библиотеки

> URL: https://foura.ai/bg/docs/getting-started/sdks-and-libraries
> Updated: 2026-07-01
> Index: https://foura.ai/llms.txt

FourA е REST API: можете да го използвате с всеки език, който поддържа HTTP. Ето примери за бърз старт в най-популярните езици.

## Python

Използване на библиотеката `requests`:

```python
import requests

response = requests.post(
    "https://eu.api.foura.ai/api/single/",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "method": "GET",
        "url": "https://example.com"
    }
)

data = response.json()
print(data["data"][:200])  # First 200 chars of response body
```

## Node.js

Използване на вградения `fetch` (Node 18+):

```javascript
const response = await fetch('https://eu.api.foura.ai/api/single/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    method: 'GET',
    url: 'https://example.com'
  })
});

const result = await response.json();
console.log(result.data.slice(0, 200));
```

## cURL

Най-лесният начин за тестване от командния ред:

```bash
curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'
```

## Go

```go
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload, _ := json.Marshal(map[string]string{
        "method": "GET",
        "url":    "https://example.com",
    })

    req, _ := http.NewRequest("POST", "https://eu.api.foura.ai/api/single/", bytes.NewBuffer(payload))
    req.Header.Set("X-API-Key", "YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}
```

## Ruby

```ruby
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://eu.api.foura.ai/api/single/')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['X-API-Key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = { method: 'GET', url: 'https://example.com' }.to_json

response = http.request(request)
puts JSON.parse(response.body)['data'][0..200]
```

## MCP Server (за LLM агенти)

Ако изграждате LLM агент (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code), пропуснете базовия HTTP клиент и използвайте [сървъра `@fouradata/mcp`](https://foura.ai/docs/mcp/server). Той предоставя и четирите FourA endpoints като нативни [Model Context Protocol](https://modelcontextprotocol.io) инструменти (`foura_auto`, `foura_single`, `foura_proxy`, `foura_browser`) с типизирани отговори, така че агентът да може да избере правилния метод, без да се налага да пишете свързващ код.

Минимална конфигурация за Claude Desktop:

```json
{
  "mcpServers": {
    "foura": {
      "command": "npx",
      "args": ["-y", "@fouradata/mcp"],
      "env": { "FOURA_API_KEY": "pk_live_..." }
    }
  }
}
```

Пълна настройка за всеки поддържан клиент: [MCP Server](https://foura.ai/docs/mcp/server).

## Следващи стъпки

- [Бърз старт](https://foura.ai/docs/getting-started/quick-start): Вашата първа заявка
- [Удостоверяване](https://foura.ai/docs/getting-started/authentication): Вземете вашия API ключ
- [API Endpoints](https://foura.ai/docs/api/endpoints): Пълна справка
- [MCP Server](https://foura.ai/docs/mcp/server): Използвайте FourA като MCP набор от инструменти
