@spora_sdk/sdk

Official TypeScript/JavaScript client for the Spora agronomic intelligence API.

Installation

npm install @spora_sdk/sdk

Quick start

import { Spora } from "@spora/sdk";

const client = new Spora({ apiKey: "spk_live_your_key_here" });

// Search species
const species = await client.searchSpecies("Rosa", { limit: 5 });

// Get crop requirements
const crop = await client.getCrop("solanum_lycopersicum");
console.log(crop.temp_optimal_min, crop.temp_optimal_max);

// AI question (paid key)
const answer = await client.ask("When should I irrigate my tomatoes?", {
  crop: "solanum_lycopersicum",
  lat: 45.4, lon: 11.0,
  tone: "concise",
});
console.log(answer.response);

// Batch
const results = await client.batch([
  { method: "weather",      params: { lat: 45.4, lon: 11.0, days: 3 } },
  { method: "should_water", params: { lat: 45.4, lon: 11.0, crop: "vitis_vinifera" } },
]);

Error handling

import { Spora, SporaError } from "@spora/sdk";

const client = new Spora({ apiKey: "spk_live_your_key_here" });

try {
  const result = await client.ask("Best cover crop for clay soil?");
} catch (e) {
  if (e instanceof SporaError) {
    console.log(e.status, e.error);
  }
}

console.log(client.rateLimit.remaining, "/", client.rateLimit.limit);

Links

• Documentation
• API Reference
• Get an API key