Skip to content

Add WellMarkedLoader document loader#1

Merged
gradill22 merged 3 commits into
mainfrom
feat/wellmarked-loader
Jun 10, 2026
Merged

Add WellMarkedLoader document loader#1
gradill22 merged 3 commits into
mainfrom
feat/wellmarked-loader

Conversation

@gradill22

Copy link
Copy Markdown
Contributor

What

Adds WellMarkedLoader, the official LangChain document loader for the WellMarked API. It wraps the wellmarked Python SDK — no duplicated HTTP logic.

  • extract mode (default): one URL → one Document with clean Markdown as page_content
  • crawl mode: same-site BFS from a root URL → one Document per successfully extracted page (failed pages skipped), blocking on the crawl job up to job_timeout
  • Metadata carries source, title, author, date, retrieved_at (ISO string), and depth for crawled pages
  • lazy_load() is truly lazy; render_js passes through to the API

Packaging

Hatchling build mirroring the Python SDK's pyproject conventions. Depends on langchain-core>=0.3,<2.0 and wellmarked>=1.1,<2.0.

Testing

5 unit tests with a faked SDK client (no network): both modes, render_js passthrough, failed-page skipping, invalid mode, laziness. All pass, and the package installs cleanly via pip (exercising the hatchling build).

🤖 Generated with Claude Code

gradill22 and others added 3 commits June 10, 2026 18:41
Official LangChain integration for the WellMarked API, wrapping the
wellmarked Python SDK. WellMarkedLoader supports extract mode (one URL,
one Document) and crawl mode (same-site BFS, one Document per
successfully extracted page, blocking on the crawl job). Markdown maps
to page_content; title/author/date/retrieved_at/depth map to metadata.

Includes hatchling packaging mirroring the Python SDK conventions,
unit tests with a faked SDK client, and README docs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
CI runs pytest across Python 3.9-3.14 on pushes to main and PRs.
Release publishes to PyPI via OIDC Trusted Publishing on a GitHub
Release, mirroring the Python-SDK workflows.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@gradill22
gradill22 merged commit 2f97423 into main Jun 10, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant