mirror of
https://github.com/0xMassi/webclaw.git
synced 2026-07-02 04:08:08 +02:00
feat(server): add OSS webclaw-server REST API binary (closes #29)
Self-hosters hitting docs/self-hosting were promised three binaries
but the OSS Docker image only shipped two. webclaw-server lived in
the closed-source hosted-platform repo, which couldn't be opened. This
adds a minimal axum REST API in the OSS repo so self-hosting actually
works without pretending to ship the cloud platform.
Crate at crates/webclaw-server/. Stateless, no database, no job queue,
single binary. Endpoints: GET /health, POST /v1/{scrape, crawl, map,
batch, extract, summarize, diff, brand}. JSON shapes mirror
api.webclaw.io for the endpoints OSS can support, so swapping between
self-hosted and hosted is a base-URL change.
Auth: optional bearer token via WEBCLAW_API_KEY / --api-key. Comparison
is constant-time (subtle::ConstantTimeEq). Open mode (no key) is
allowed and binds 127.0.0.1 by default; the Docker image flips
WEBCLAW_HOST=0.0.0.0 so the container is reachable out of the box.
Hard caps to keep naive callers from OOMing the process: crawl capped
at 500 pages synchronously, batch capped at 100 URLs / 20 concurrent.
For unbounded crawls or anti-bot bypass the docs point users at the
hosted API.
Dockerfile + Dockerfile.ci updated to copy webclaw-server into
/usr/local/bin and EXPOSE 3000. Workspace version bumped to 0.4.0
(new public binary).
This commit is contained in:
parent
b4bfff120e
commit
2ba682adf3
20 changed files with 1116 additions and 11 deletions
108
crates/webclaw-server/src/routes/scrape.rs
Normal file
108
crates/webclaw-server/src/routes/scrape.rs
Normal file
|
|
@ -0,0 +1,108 @@
|
|||
//! POST /v1/scrape — fetch a URL, run extraction, return the requested
|
||||
//! formats. JSON shape mirrors the hosted-API response where possible so
|
||||
//! migrating from self-hosted → cloud is a config change, not a code one.
|
||||
|
||||
use axum::{Json, extract::State};
|
||||
use serde::Deserialize;
|
||||
use serde_json::{Value, json};
|
||||
use webclaw_core::{ExtractionOptions, llm::to_llm_text};
|
||||
|
||||
use crate::{error::ApiError, state::AppState};
|
||||
|
||||
#[derive(Debug, Deserialize, Default)]
|
||||
#[serde(default)]
|
||||
pub struct ScrapeRequest {
|
||||
pub url: String,
|
||||
/// Output formats. Allowed: "markdown", "text", "llm", "json", "html".
|
||||
/// Defaults to ["markdown"]. Accepts a single string ("format")
|
||||
/// or an array ("formats") for hosted-API compatibility.
|
||||
#[serde(alias = "format")]
|
||||
pub formats: ScrapeFormats,
|
||||
pub include_selectors: Vec<String>,
|
||||
pub exclude_selectors: Vec<String>,
|
||||
pub only_main_content: bool,
|
||||
}
|
||||
|
||||
#[derive(Debug, Deserialize)]
|
||||
#[serde(untagged)]
|
||||
pub enum ScrapeFormats {
|
||||
One(String),
|
||||
Many(Vec<String>),
|
||||
}
|
||||
|
||||
impl Default for ScrapeFormats {
|
||||
fn default() -> Self {
|
||||
Self::Many(vec!["markdown".into()])
|
||||
}
|
||||
}
|
||||
|
||||
impl ScrapeFormats {
|
||||
fn as_vec(&self) -> Vec<String> {
|
||||
match self {
|
||||
Self::One(s) => vec![s.clone()],
|
||||
Self::Many(v) => v.clone(),
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
pub async fn scrape(
|
||||
State(state): State<AppState>,
|
||||
Json(req): Json<ScrapeRequest>,
|
||||
) -> Result<Json<Value>, ApiError> {
|
||||
if req.url.trim().is_empty() {
|
||||
return Err(ApiError::bad_request("`url` is required"));
|
||||
}
|
||||
let formats = req.formats.as_vec();
|
||||
|
||||
let options = ExtractionOptions {
|
||||
include_selectors: req.include_selectors,
|
||||
exclude_selectors: req.exclude_selectors,
|
||||
only_main_content: req.only_main_content,
|
||||
include_raw_html: formats.iter().any(|f| f == "html"),
|
||||
};
|
||||
|
||||
let extraction = state
|
||||
.fetch()
|
||||
.fetch_and_extract_with_options(&req.url, &options)
|
||||
.await?;
|
||||
|
||||
let mut body = json!({
|
||||
"url": extraction.metadata.url.clone().unwrap_or_else(|| req.url.clone()),
|
||||
"metadata": extraction.metadata,
|
||||
});
|
||||
let obj = body.as_object_mut().expect("json::object");
|
||||
|
||||
for f in &formats {
|
||||
match f.as_str() {
|
||||
"markdown" => {
|
||||
obj.insert("markdown".into(), json!(extraction.content.markdown));
|
||||
}
|
||||
"text" => {
|
||||
obj.insert("text".into(), json!(extraction.content.plain_text));
|
||||
}
|
||||
"llm" => {
|
||||
let llm = to_llm_text(&extraction, extraction.metadata.url.as_deref());
|
||||
obj.insert("llm".into(), json!(llm));
|
||||
}
|
||||
"html" => {
|
||||
if let Some(raw) = &extraction.content.raw_html {
|
||||
obj.insert("html".into(), json!(raw));
|
||||
}
|
||||
}
|
||||
"json" => {
|
||||
obj.insert("json".into(), json!(extraction));
|
||||
}
|
||||
other => {
|
||||
return Err(ApiError::bad_request(format!(
|
||||
"unknown format: '{other}' (allowed: markdown, text, llm, html, json)"
|
||||
)));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if !extraction.structured_data.is_empty() {
|
||||
obj.insert("structured_data".into(), json!(extraction.structured_data));
|
||||
}
|
||||
|
||||
Ok(Json(body))
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue