🕷️ Arachne SDK — Python
Python SDK oficial para a API pública do Arachne — plataforma universal de extração, busca, RAG, visão computacional e transcrição de áudio.
pip install arachne-sdk
🚀 Uso rápido
from arachne_sdk import Arachne
# Crie seu client com sua API key
client = Arachne(api_key="arn_sua_chave_aqui")
# 🕸️ Extrair conteúdo de uma página
result = client.extract("https://example.com")
print(result.markdown[:500])
# 🔍 Buscar na web
search = client.search("últimas notícias IA")
for r in search.results:
print(f"{r['title']}: {r['url']}")
# 📊 Ver uso da API
usage = client.usage()
print(f"Usado: {usage.monthly_used}/{usage.monthly_limit} requisições")
⚡ Async
import asyncio
from arachne_sdk import Arachne
async def main():
async with Arachne(api_key="arn_sua_chave") as client:
# Extração assíncrona
result = await client.extract_async("https://example.com")
print(result.title)
# Busca assíncrona
search = await client.search_async("Python SDK")
print(f"{search.total} resultados")
asyncio.run(main())
🧰 Métodos disponíveis
| Método | Async | Descrição |
|---|---|---|
status() |
✅ | Health check da API |
capabilities() |
✅ | Lista capacidades do Arachne |
search(query, limit) |
✅ | Busca web via DuckDuckGo |
scrape(url, ...) |
✅ | Scraping de página web |
scrape_many(urls, ...) |
❌ | Scraping em lote |
extract(url, ...) |
✅ | Extração universal (qualquer URL) |
get_job(job_id) |
✅ | Detalhes de um job |
list_jobs(...) |
❌ | Lista jobs recentes |
delete_job(job_id) |
✅ | Remove um job |
query_rag(question, kb_id) |
✅ | Consulta Knowledge Base (RAG) |
analyze_image(image_url, ...) |
✅ | Análise de imagem (OCR + VLM) |
transcribe(url, ...) |
✅ | Transcrição de áudio/vídeo (Whisper) |
list_pipelines() |
❌ | Lista pipelines agendados |
create_pipeline(url, cron, ...) |
❌ | Cria pipeline agendado |
delete_pipeline(id) |
✅ | Remove pipeline |
usage() |
✅ | Estatísticas de uso |
plans() |
❌ | Lista planos disponíveis |
📦 Instalação
pip install arachne-sdk
Dependências opcionais
pip install arachne-sdk[full] # + pandas, pillow
🔑 Obtendo uma API Key
- Acesse arachne.seu.pet
- Crie uma conta ou faça login
- Vá em Configurações → API Keys
- Gere uma nova chave (formato:
arn_...)
🏗 Exemplos completos
Veja a pasta examples/ para exemplos detalhados de cada funcionalidade.
📄 Licença
MIT
Metadata
Release files for arachne-sdk 0.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| arachne_sdk-0.2.3.tar.gz | 9.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| arachne_sdk-0.2.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 18.4 kB
Release files / arachne_sdk-0.2.3.tar.gz
| Download URL | arachne_sdk-0.2.3.tar.gz |
|---|---|
| Size | 9.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b77bb558acb572af7a2fdae447ee1c6a3f9782817c700eec0e04653dd860bfb9
|
|
BLAKE2b-256 checksum How to use checksums |
ce5fa9ee4657c3934387883d2accd6b4645630ba7204ecfbbf08cdab1ebd7da1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Release files / arachne_sdk-0.2.3-py3-none-any.whl
| Download URL | arachne_sdk-0.2.3-py3-none-any.whl |
|---|---|
| Size | 8.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1bcb9d2f570ccd1e88d9ab1e6c77dfc19609502d792600e3014efe4d9ed42cb2
|
|
BLAKE2b-256 checksum How to use checksums |
7f628c88784a92a90ac57da767072e005c1615e7302dc373d09c807bb88619d9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|