Cuanto tiempo lleva este tutorial de cómo extraer datos comerciales locales sin código?

La mayoria de los desarrolladores completan este tutorial en 15 a 30 minutos. Necesitaras una clave API de Scavio (el plan gratuito funciona) y un entorno de Python o JavaScript.

Que necesito antes de empezar?

Un terminal con curl instalado (macOS/Linux integrado, Windows a través de Git Bash). Una clave API de Scavio de scavio.dev. Una herramienta de hoja de cálculo (Google Sheets, Excel o LibreOffice). jq instalado para procesamiento JSON (opcional pero recomendado). Una clave API de Scavio te da 50 creditos gratuitos al registrarte.

Puedo ejecutar este tutorial con el plan gratuito?

Si. El plan gratuito incluye 50 creditos al registrarte, mas que suficiente para completar este tutorial y crear un prototipo funcional.

Con que frameworks funciona esto?

Scavio tiene un paquete nativo de LangChain (langchain-scavio), un servidor MCP y una API REST simple que funciona con cualquier cliente HTTP. Este tutorial usa the raw REST API, pero puedes adaptarlo al framework que prefieras.

Extraer datos comerciales locales sin código (2026)

No es necesario ser desarrollador para extraer datos comerciales locales de los resultados de búsqueda. Con curl y una clave API de Scavio, puede obtener nombres de empresas, calificaciones, direcciones y números de teléfono de cualquier ubicación. Canalice la salida a un archivo JSON, ábralo en una herramienta de hoja de cálculo y tendrá una base de datos empresarial local. Cada búsqueda cuesta $0,005. Este tutorial recorre todo el proceso utilizando únicamente comandos de terminal y herramientas gratuitas.

Requisitos previos

Un terminal con curl instalado (macOS/Linux integrado, Windows a través de Git Bash)
Una clave API de Scavio de scavio.dev
Una herramienta de hoja de cálculo (Google Sheets, Excel o LibreOffice)
jq instalado para procesamiento JSON (opcional pero recomendado)

Guia paso a paso

Paso 1: Ejecute su primera búsqueda de empresas locales

Utilice curl para PUBLICAR una consulta de búsqueda en la API de Scavio. La respuesta incluye resultados de paquetes locales con nombres comerciales, calificaciones y direcciones.

Bash

# Set your API key
export SCAVIO_API_KEY="your_key_here"

# Search for local businesses
curl -s -X POST https://api.scavio.dev/api/v1/search \
  -H "x-api-key: $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "best pizza in Chicago", "country_code": "us", "num_results": 10}' \
  | python3 -m json.tool

# With jq for cleaner output
curl -s -X POST https://api.scavio.dev/api/v1/search \
  -H "x-api-key: $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "best pizza in Chicago", "country_code": "us", "num_results": 10}' \
  | jq '.local_results[] | {name: .title, rating: .rating, address: .address}'

Paso 2: Extraer datos comerciales a un archivo JSON

Guarde los resultados de la búsqueda en archivos para cada categoría empresarial. Ejecute múltiples búsquedas para crear una base de datos completa.

Bash

# Search multiple categories and save results
for category in "restaurants" "dentists" "plumbers" "hair salons"; do
  echo "Searching: $category in Chicago"
  curl -s -X POST https://api.scavio.dev/api/v1/search \
    -H "x-api-key: $SCAVIO_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"query\": \"$category in Chicago IL\", \"country_code\": \"us\", \"num_results\": 10}" \
    > "${category}_chicago.json"
  sleep 1  # Rate limiting
done

# Verify the files
for f in *_chicago.json; do
  count=$(jq '.local_results | length' "$f" 2>/dev/null || echo 0)
  echo "$f: $count local results"
done

Paso 3: Convierta JSON a CSV usando jq

Transforme los resultados JSON a formato CSV que cualquier hoja de cálculo pueda importar. Extrae los campos que necesitas: nombre, valoración, reseñas, dirección, teléfono.

Bash

# Convert a single file to CSV
echo "name,rating,reviews,address,phone" > chicago_businesses.csv

for f in *_chicago.json; do
  category=$(echo "$f" | sed 's/_chicago.json//')
  jq -r --arg cat "$category" \
    '.local_results[]? | [.title // "", .rating // "", .reviews // "", .address // "", .phone // "", $cat] | @csv' \
    "$f" >> chicago_businesses.csv 2>/dev/null
done

# Preview the CSV
head -10 chicago_businesses.csv
echo ""
wc -l chicago_businesses.csv | awk '{print $1 - 1, "businesses extracted"}'

Paso 4: Cree un script bash simple para extracción repetible

Envuelva todo el proceso en un script reutilizable. Pase en una ciudad y obtenga un CSV de empresas locales.

Bash

#!/bin/bash
# local_business_extract.sh - Extract local businesses for any city
# Usage: ./local_business_extract.sh "Austin TX"

CITY="${1:-Austin TX}"
SAFE_CITY=$(echo "$CITY" | tr ' ' '_' | tr '[:upper:]' '[:lower:]')
OUTPUT="${SAFE_CITY}_businesses.csv"
CATEGORIES=("restaurants" "dentists" "plumbers" "electricians" "hair salons")

echo "Extracting businesses in $CITY"
echo "name,category,rating,reviews,address" > "$OUTPUT"

for cat in "${CATEGORIES[@]}"; do
  echo "  Searching: $cat"
  RESULT=$(curl -s -X POST https://api.scavio.dev/api/v1/search \
    -H "x-api-key: $SCAVIO_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"query\": \"$cat in $CITY\", \"country_code\": \"us\", \"num_results\": 10}")
  echo "$RESULT" | jq -r --arg cat "$cat" \
    '.local_results[]? | [.title // "", $cat, .rating // "", .reviews // "", .address // ""] | @csv' \
    >> "$OUTPUT" 2>/dev/null
  sleep 1
done

TOTAL=$(tail -n +2 "$OUTPUT" | wc -l | tr -d ' ')
COST=$(echo "${#CATEGORIES[@]} * 0.005" | bc)
echo "Done: $TOTAL businesses saved to $OUTPUT"
echo "Cost: \$$COST (${#CATEGORIES[@]} searches at \$0.005 each)"

Ejemplo en Python

Python

import os, requests, csv

SCAVIO_KEY = os.environ['SCAVIO_API_KEY']
H = {'x-api-key': SCAVIO_KEY, 'Content-Type': 'application/json'}

def extract_businesses(city, categories):
    all_biz = []
    for cat in categories:
        resp = requests.post('https://api.scavio.dev/api/v1/search', headers=H,
            json={'query': f'{cat} in {city}', 'country_code': 'us', 'num_results': 10})
        for r in resp.json().get('local_results', []):
            all_biz.append({'name': r.get('title',''), 'category': cat,
                'rating': r.get('rating',''), 'address': r.get('address','')})
    with open(f'{city.replace(" ","_").lower()}.csv', 'w', newline='') as f:
        w = csv.DictWriter(f, fieldnames=['name','category','rating','address'])
        w.writeheader()
        w.writerows(all_biz)
    print(f'Exported {len(all_biz)} businesses')

extract_businesses('Austin TX', ['restaurants', 'dentists'])

Ejemplo en JavaScript

JavaScript

const SCAVIO_KEY = process.env.SCAVIO_API_KEY;

async function extractBusinesses(city, categories) {
  const all = [];
  for (const cat of categories) {
    const resp = await fetch('https://api.scavio.dev/api/v1/search', {
      method: 'POST',
      headers: { 'x-api-key': SCAVIO_KEY, 'Content-Type': 'application/json' },
      body: JSON.stringify({ query: `${cat} in ${city}`, country_code: 'us', num_results: 10 })
    });
    const local = (await resp.json()).local_results || [];
    local.forEach(r => all.push({ name: r.title, category: cat, rating: r.rating, address: r.address }));
  }
  console.log(`Found ${all.length} businesses in ${city}`);
  all.forEach(b => console.log(`  ${b.name} (${b.rating}) - ${b.category}`));
}

extractBusinesses('Austin TX', ['restaurants', 'dentists']);

Salida esperada

JSON

Extracting businesses in Austin TX
  Searching: restaurants
  Searching: dentists
  Searching: plumbers
  Searching: electricians
  Searching: hair salons
Done: 32 businesses saved to austin_tx_businesses.csv
Cost: $0.025 (5 searches at $0.005 each)

name,category,rating,reviews,address
"Franklin Barbecue",restaurants,4.8,4521,"900 E 11th St, Austin, TX"
"Uchi Austin",restaurants,4.7,2103,"801 S Lamar Blvd, Austin, TX"

Tutoriales relacionados

Requisitos previos

Un terminal con curl instalado (macOS/Linux integrado, Windows a través de Git Bash)
Una clave API de Scavio de scavio.dev
Una herramienta de hoja de cálculo (Google Sheets, Excel o LibreOffice)
jq instalado para procesamiento JSON (opcional pero recomendado)

Guia paso a paso

Paso 1: Ejecute su primera búsqueda de empresas locales

Utilice curl para PUBLICAR una consulta de búsqueda en la API de Scavio. La respuesta incluye resultados de paquetes locales con nombres comerciales, calificaciones y direcciones.

Bash

# Set your API key
export SCAVIO_API_KEY="your_key_here"

# Search for local businesses
curl -s -X POST https://api.scavio.dev/api/v1/search \
  -H "x-api-key: $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "best pizza in Chicago", "country_code": "us", "num_results": 10}' \
  | python3 -m json.tool

# With jq for cleaner output
curl -s -X POST https://api.scavio.dev/api/v1/search \
  -H "x-api-key: $SCAVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "best pizza in Chicago", "country_code": "us", "num_results": 10}' \
  | jq '.local_results[] | {name: .title, rating: .rating, address: .address}'

Paso 2: Extraer datos comerciales a un archivo JSON

Guarde los resultados de la búsqueda en archivos para cada categoría empresarial. Ejecute múltiples búsquedas para crear una base de datos completa.

Bash

# Search multiple categories and save results
for category in "restaurants" "dentists" "plumbers" "hair salons"; do
  echo "Searching: $category in Chicago"
  curl -s -X POST https://api.scavio.dev/api/v1/search \
    -H "x-api-key: $SCAVIO_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"query\": \"$category in Chicago IL\", \"country_code\": \"us\", \"num_results\": 10}" \
    > "${category}_chicago.json"
  sleep 1  # Rate limiting
done

# Verify the files
for f in *_chicago.json; do
  count=$(jq '.local_results | length' "$f" 2>/dev/null || echo 0)
  echo "$f: $count local results"
done

Paso 3: Convierta JSON a CSV usando jq

Transforme los resultados JSON a formato CSV que cualquier hoja de cálculo pueda importar. Extrae los campos que necesitas: nombre, valoración, reseñas, dirección, teléfono.

Bash

# Convert a single file to CSV
echo "name,rating,reviews,address,phone" > chicago_businesses.csv

for f in *_chicago.json; do
  category=$(echo "$f" | sed 's/_chicago.json//')
  jq -r --arg cat "$category" \
    '.local_results[]? | [.title // "", .rating // "", .reviews // "", .address // "", .phone // "", $cat] | @csv' \
    "$f" >> chicago_businesses.csv 2>/dev/null
done

# Preview the CSV
head -10 chicago_businesses.csv
echo ""
wc -l chicago_businesses.csv | awk '{print $1 - 1, "businesses extracted"}'

Paso 4: Cree un script bash simple para extracción repetible

Envuelva todo el proceso en un script reutilizable. Pase en una ciudad y obtenga un CSV de empresas locales.

Bash

#!/bin/bash
# local_business_extract.sh - Extract local businesses for any city
# Usage: ./local_business_extract.sh "Austin TX"

CITY="${1:-Austin TX}"
SAFE_CITY=$(echo "$CITY" | tr ' ' '_' | tr '[:upper:]' '[:lower:]')
OUTPUT="${SAFE_CITY}_businesses.csv"
CATEGORIES=("restaurants" "dentists" "plumbers" "electricians" "hair salons")

echo "Extracting businesses in $CITY"
echo "name,category,rating,reviews,address" > "$OUTPUT"

for cat in "${CATEGORIES[@]}"; do
  echo "  Searching: $cat"
  RESULT=$(curl -s -X POST https://api.scavio.dev/api/v1/search \
    -H "x-api-key: $SCAVIO_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"query\": \"$cat in $CITY\", \"country_code\": \"us\", \"num_results\": 10}")
  echo "$RESULT" | jq -r --arg cat "$cat" \
    '.local_results[]? | [.title // "", $cat, .rating // "", .reviews // "", .address // ""] | @csv' \
    >> "$OUTPUT" 2>/dev/null
  sleep 1
done

TOTAL=$(tail -n +2 "$OUTPUT" | wc -l | tr -d ' ')
COST=$(echo "${#CATEGORIES[@]} * 0.005" | bc)
echo "Done: $TOTAL businesses saved to $OUTPUT"
echo "Cost: \$$COST (${#CATEGORIES[@]} searches at \$0.005 each)"

Ejemplo en Python

Python

import os, requests, csv

SCAVIO_KEY = os.environ['SCAVIO_API_KEY']
H = {'x-api-key': SCAVIO_KEY, 'Content-Type': 'application/json'}

def extract_businesses(city, categories):
    all_biz = []
    for cat in categories:
        resp = requests.post('https://api.scavio.dev/api/v1/search', headers=H,
            json={'query': f'{cat} in {city}', 'country_code': 'us', 'num_results': 10})
        for r in resp.json().get('local_results', []):
            all_biz.append({'name': r.get('title',''), 'category': cat,
                'rating': r.get('rating',''), 'address': r.get('address','')})
    with open(f'{city.replace(" ","_").lower()}.csv', 'w', newline='') as f:
        w = csv.DictWriter(f, fieldnames=['name','category','rating','address'])
        w.writeheader()
        w.writerows(all_biz)
    print(f'Exported {len(all_biz)} businesses')

extract_businesses('Austin TX', ['restaurants', 'dentists'])

Ejemplo en JavaScript

JavaScript

const SCAVIO_KEY = process.env.SCAVIO_API_KEY;

async function extractBusinesses(city, categories) {
  const all = [];
  for (const cat of categories) {
    const resp = await fetch('https://api.scavio.dev/api/v1/search', {
      method: 'POST',
      headers: { 'x-api-key': SCAVIO_KEY, 'Content-Type': 'application/json' },
      body: JSON.stringify({ query: `${cat} in ${city}`, country_code: 'us', num_results: 10 })
    });
    const local = (await resp.json()).local_results || [];
    local.forEach(r => all.push({ name: r.title, category: cat, rating: r.rating, address: r.address }));
  }
  console.log(`Found ${all.length} businesses in ${city}`);
  all.forEach(b => console.log(`  ${b.name} (${b.rating}) - ${b.category}`));
}

extractBusinesses('Austin TX', ['restaurants', 'dentists']);

Salida esperada

JSON

Extracting businesses in Austin TX
  Searching: restaurants
  Searching: dentists
  Searching: plumbers
  Searching: electricians
  Searching: hair salons
Done: 32 businesses saved to austin_tx_businesses.csv
Cost: $0.025 (5 searches at $0.005 each)

name,category,rating,reviews,address
"Franklin Barbecue",restaurants,4.8,4521,"900 E 11th St, Austin, TX"
"Uchi Austin",restaurants,4.7,2103,"801 S Lamar Blvd, Austin, TX"

Cómo extraer datos comerciales locales sin código

Requisitos previos

Guia paso a paso

Paso 1: Ejecute su primera búsqueda de empresas locales

Paso 2: Extraer datos comerciales a un archivo JSON

Paso 3: Convierta JSON a CSV usando jq

Paso 4: Cree un script bash simple para extracción repetible

Ejemplo en Python

Ejemplo en JavaScript

Salida esperada

Tutoriales relacionados

Preguntas frecuentes

Cuanto tiempo lleva este tutorial de cómo extraer datos comerciales locales sin código?

Que necesito antes de empezar?

Puedo ejecutar este tutorial con el plan gratuito?

Con que frameworks funciona esto?

Recursos relacionados

Las mejores API de datos comerciales de Google Maps (mayo de 2026)

Las mejores API de búsqueda después de los cambios en el modo AI de Google I/O 2026

Costo de la API de Google Maps Places

Panorama de proveedores de API de búsqueda (2026)

Google CSE (Paid Tier) vs Third-Party SERP API (Scavio, SerpApi, Serper)

Google Places API vs SERP Local Pack API

Empieza a construir

Cómo extraer datos comerciales locales sin código

Requisitos previos

Guia paso a paso

Paso 1: Ejecute su primera búsqueda de empresas locales

Paso 2: Extraer datos comerciales a un archivo JSON

Paso 3: Convierta JSON a CSV usando jq

Paso 4: Cree un script bash simple para extracción repetible

Ejemplo en Python

Ejemplo en JavaScript

Salida esperada

Tutoriales relacionados

Preguntas frecuentes

Cuanto tiempo lleva este tutorial de cómo extraer datos comerciales locales sin código?

Que necesito antes de empezar?

Puedo ejecutar este tutorial con el plan gratuito?

Con que frameworks funciona esto?

Recursos relacionados

Las mejores API de datos comerciales de Google Maps (mayo de 2026)

Las mejores API de búsqueda después de los cambios en el modo AI de Google I/O 2026

Costo de la API de Google Maps Places

Panorama de proveedores de API de búsqueda (2026)

Google CSE (Paid Tier) vs Third-Party SERP API (Scavio, SerpApi, Serper)

Google Places API vs SERP Local Pack API

Empieza a construir