← 返回 Skills 市场
justserpapi

Web Crawling API

作者 justserpapi · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
124
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install justserpapi-web
功能描述
Fetch raw HTML, rendered HTML, or clean Markdown from public webpages through Just Serp API.
使用说明 (SKILL.md)

Web Crawling

Use this skill when the user needs webpage retrieval rather than a search engine result. It fits crawling, scraping preparation, readable content extraction, and page structure inspection for a known URL.

When To Use It

  • The user already has a target webpage URL and wants its raw HTML, rendered HTML, or cleaned Markdown.
  • The task is about content extraction, page inspection, scrape preparation, or converting a page into LLM-friendly text.
  • The user can provide a direct url to crawl.
  • The user needs page content from the source URL itself, not Google search results about that URL.

Representative Operations

  • html: Crawl Webpage (HTML) — Retrieve the raw HTML response for a page.
  • renderedHtml: Crawl Webpage (Rendered HTML) — Retrieve DOM output after rendering for JavaScript-heavy pages.
  • markdown: Crawl Webpage (Markdown) — Extract the main readable content as clean Markdown for summarization or downstream processing.

Request Pattern

  • 3 read-only GET operations are available in this skill.
  • All operations require a direct url query parameter.
  • No operation in this skill requires a request body.
  • Choose renderedHtml for dynamic pages, html for raw source, and markdown for readable content extraction.

How To Work

  1. Read generated/operations.md before choosing an endpoint.
  2. Start with one of these operations when it matches the user's request: html, renderedHtml, markdown.
  3. Pick the smallest matching operation instead of guessing.
  4. Ask the user for any missing required parameter. Do not invent values.
  5. Call the helper with:
node {baseDir}/bin/run.mjs --operation "\x3Coperation-id>" --api-key "$JUST_SERP_API_KEY" --params-json '{"key":"value"}'

Environment

  • Required: JUST_SERP_API_KEY
  • This skill uses JUST_SERP_API_KEY only for authenticated Just Serp API requests.
  • Keep JUST_SERP_API_KEY private. Do not paste it into chat messages, screenshots, or logs.
  • Project site: Just Serp API.
  • Authentication details: Just Serp API Docs.

Output Rules

  • Start with what was fetched: raw HTML, rendered HTML, or cleaned Markdown.
  • Echo the target URL so the crawl scope is explicit.
  • For markdown, surface the extracted readable content or key sections before raw JSON.
  • For HTML-oriented requests, mention whether the user asked for source HTML or rendered output.
  • If the backend errors, include the backend payload and the exact operation ID.
安全使用建议
This skill sends the target URL (and the API key you provide when invoking it) to a third‑party service (Just Serp API). Only use it for public pages or content you are authorized to share. Keep JUST_SERP_API_KEY secret and store it securely (don’t paste it into chat). Review Just Serp’s privacy, retention, and billing policies (requests may incur cost and content will be processed by their servers). If you need entirely local crawling (no network calls to external providers), consider a local crawler instead.
功能分析
Type: OpenClaw Skill Name: justserpapi-web Version: 1.0.1 The skill is a standard API wrapper for the Just Serp web crawling service, allowing the agent to retrieve HTML or Markdown content from URLs. The implementation in `bin/run.mjs` is straightforward, using the `fetch` API to communicate with `api.justserpapi.com` and properly handling the `JUST_SERP_API_KEY` via request headers. No evidence of data exfiltration, malicious execution, or prompt injection was found.
能力评估
Purpose & Capability
Name/description (fetching HTML/Markdown via Just Serp) align with the declared requirement for JUST_SERP_API_KEY and node. The operations and manifest point only to api.justserpapi.com endpoints that match the stated purpose.
Instruction Scope
SKILL.md directs the agent to call the local helper (bin/run.mjs) with --operation, --params-json and the API key. It asks the agent to request missing parameters from the user and not to invent values. There are no instructions to read unrelated files, environment variables, or to exfiltrate data to unexpected endpoints.
Install Mechanism
No install spec is present (instruction-only), and the single included script is a small Node CLI that issues HTTP requests. No external downloads, extract steps, or third-party package installs are performed by the skill itself.
Credentials
The skill requires one API key (JUST_SERP_API_KEY), which is the primary credential needed to authenticate to Just Serp API. No unrelated secrets or multiple unrelated credentials are requested.
Persistence & Privilege
The skill is not forced-always, does not modify other skills or system configuration, and does not request persistent elevated privileges.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install justserpapi-web
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /justserpapi-web 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
- Updated homepage, project site, and authentication documentation links to include referral tracking parameters. - No changes to functionality or API usage; documentation/metadata update only.
v1.0.0
Initial publish
元数据
Slug justserpapi-web
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Web Crawling API 是什么?

Fetch raw HTML, rendered HTML, or clean Markdown from public webpages through Just Serp API. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 124 次。

如何安装 Web Crawling API?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install justserpapi-web」即可一键安装,无需额外配置。

Web Crawling API 是免费的吗?

是的,Web Crawling API 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Web Crawling API 支持哪些平台?

Web Crawling API 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Web Crawling API?

由 justserpapi(@justserpapi)开发并维护,当前版本 v1.0.1。

💬 留言讨论