Una publicación de r/HalalInvestor lanzó Yassir v0.1.0, un agente de investigación OSS que cumple con la Shariah. Su pila utilizaba cuatro proveedores de búsqueda web más HalalTerminal. Este tutorial consolida la capa web de Scavio manteniendo los fundamentos de una API especializada.
Requisitos previos
- Python 3.10+ o TypeScript/Bun
- Clave API de Scavio
- Nivel gratuito de Polygon.io
Guia paso a paso
Paso 1: Reemplazar la cadena de respaldo web de cuatro proveedores
Una llamada de Scavio cubre lo que hicieron Brave + Tavily + Exa + Perplexity.
Python
import requests, os
API_KEY = os.environ['SCAVIO_API_KEY']
def web(q):
return requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': API_KEY}, json={'query': q}).json()Paso 2: Capa de sentimiento minorista de Reddit
r/halalinvesting, r/wallstreetbets muestran cambios en el sentimiento.
Python
def reddit(q):
return requests.post('https://api.scavio.dev/api/v1/reddit/search',
headers={'x-api-key': API_KEY}, json={'query': q}).json()Paso 3: Polígono para fundamentos
Nivel gratuito retrasado pero aceptable para investigación.
Python
from polygon import RESTClient
client = RESTClient(api_key=os.environ['POLYGON_API_KEY'])
def fundamentals(ticker):
return client.get_ticker_details(ticker)Paso 4: Filtro Shariah en el mensaje del agente
El LLM aplica filtros riba / gharar / haram.
Text
RULES = '''
Reject if: interest-bearing debt > 33% of market cap; alcohol/gambling/conventional finance revenue > 5%.
Flag for purification if: small interest income.
'''Paso 5: Redactar respuesta obtenida
Tres superficies + fundamentos + filtro Shariah.
Python
def research(ticker):
return {'web': web(f'{ticker} 2026 financials'), 'reddit': reddit(ticker), 'fundamentals': fundamentals(ticker)}Ejemplo en Python
Python
# Per-question cost: 2-3 Scavio calls + 1 Polygon call. Total ~$0.013 + Polygon (free tier).Ejemplo en JavaScript
JavaScript
// TypeScript / Bun version uses the same endpoints.Salida esperada
JSON
Per-ticker research brief: web summary, retail sentiment, fundamentals, Shariah-compliance verdict.