{"id":51587611,"url":"https://github.com/justserpapi/justserpapi-openclaw-websearch","last_synced_at":"2026-07-11T12:01:27.339Z","repository":{"id":364569245,"uuid":"1217833058","full_name":"justserpapi/justserpapi-openclaw-websearch","owner":"justserpapi","description":"JustSerpAPI web search provider plugin for OpenClaw, enabling OpenClaw web_search to use JustSerpAPI as a search engine.","archived":false,"fork":false,"pushed_at":"2026-07-04T17:54:07.000Z","size":2474,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-04T18:12:24.178Z","etag":null,"topics":["openclaw","openclaw-plugin","openclaw-websearch"],"latest_commit_sha":null,"homepage":"https://justserpapi.com/?utm_source=github\u0026utm_medium=referral\u0026utm_campaign=openclaw_websearch\u0026utm_content=repo_about_link","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/justserpapi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-22T09:05:47.000Z","updated_at":"2026-07-04T17:54:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/justserpapi/justserpapi-openclaw-websearch","commit_stats":null,"previous_names":["justserpapi/justserpapi-openclaw-websearch"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/justserpapi/justserpapi-openclaw-websearch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justserpapi%2Fjustserpapi-openclaw-websearch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justserpapi%2Fjustserpapi-openclaw-websearch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justserpapi%2Fjustserpapi-openclaw-websearch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justserpapi%2Fjustserpapi-openclaw-websearch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/justserpapi","download_url":"https://codeload.github.com/justserpapi/justserpapi-openclaw-websearch/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justserpapi%2Fjustserpapi-openclaw-websearch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35361644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-11T02:00:05.354Z","response_time":104,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["openclaw","openclaw-plugin","openclaw-websearch"],"created_at":"2026-07-11T12:01:26.679Z","updated_at":"2026-07-11T12:01:27.332Z","avatar_url":"https://github.com/justserpapi.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# JustSerpAPI OpenClaw Web Search Provider\n\nOpenClaw native plugin that registers `justserpapi` as a `web_search` provider.\nIt lets OpenClaw use [JustSerpAPI](https://justserpapi.com) for Google SERP-backed web search.\n\n## Requirements\n\n- OpenClaw with plugin support\n- Node.js `\u003e=22.14.0`\n- A JustSerpAPI API key from the JustSerpAPI dashboard\n\n## Install From GitHub\n\nOpenClaw installs native plugins from local paths. For GitHub distribution, clone this public repo first, then install the local plugin directory.\n\n```bash\ngit clone https://github.com/justserpapi/justserpapi-openclaw-websearch.git\ncd justserpapi-openclaw-websearch\nopenclaw plugins install . --link\nopenclaw plugins enable justserpapi\n```\n\nUse `--link` while testing or developing so OpenClaw loads the checked-out repository. For a copied install instead, omit `--link`:\n\n```bash\nopenclaw plugins install .\n```\n\nConfirm OpenClaw can see the plugin:\n\n```bash\nopenclaw plugins list --enabled\nopenclaw plugins inspect justserpapi\n```\n\n## Install From GitHub Marketplace\n\nThis repository also ships a marketplace manifest at `.claude-plugin/marketplace.json`, so users can install the plugin from the public GitHub repo without npm publishing.\n\nInspect the marketplace:\n\n```bash\nopenclaw plugins marketplace list justserpapi/justserpapi-openclaw-websearch\n```\n\nInstall from the marketplace:\n\n```bash\nopenclaw plugins install justserpapi --marketplace justserpapi/justserpapi-openclaw-websearch\nopenclaw plugins enable justserpapi\n```\n\nThe full GitHub URL works too:\n\n```bash\nopenclaw plugins install justserpapi --marketplace https://github.com/justserpapi/justserpapi-openclaw-websearch\n```\n\nFor remote marketplaces, OpenClaw requires plugin sources to be relative paths inside the marketplace repository. This plugin's marketplace entry uses `\"source\": \".\"`, pointing at this native OpenClaw plugin root.\n\n## Configure\n\nAdd the provider config to your OpenClaw config:\n\n```json\n{\n  \"plugins\": {\n    \"entries\": {\n      \"justserpapi\": {\n        \"enabled\": true,\n        \"config\": {\n          \"webSearch\": {\n            \"apiKey\": \"YOUR_JUSTSERPAPI_KEY\",\n            \"baseUrl\": \"https://api.justserpapi.com\"\n          }\n        }\n      }\n    }\n  },\n  \"tools\": {\n    \"web\": {\n      \"search\": {\n        \"enabled\": true,\n        \"provider\": \"justserpapi\",\n        \"maxResults\": 5,\n        \"timeoutSeconds\": 30\n      }\n    }\n  }\n}\n```\n\nYou can also provide credentials with environment variables:\n\n```bash\nexport JUSTSERPAPI_API_KEY=\"YOUR_JUSTSERPAPI_KEY\"\n```\n\nSupported environment fallbacks:\n\n- `JUSTSERPAPI_API_KEY`\n- `JUSTSERP_API_KEY`\n- `JUSTSERPAPI_BASE_URL`\n- `JUSTSERP_BASE_URL`\n\n## Optional Settings\n\nUnder `plugins.entries.justserpapi.config.webSearch`:\n\n- `apiKey`: JustSerpAPI API key.\n- `baseUrl`: API base URL, defaults to `https://api.justserpapi.com`.\n- `language`: default Google language code, such as `en`.\n- `country`: default Google country code, such as `us`.\n- `safeSearch`: `active` or `off`.\n- `count`: default result count, clamped to 1-10.\n\nTool-call parameters can override the configured defaults:\n\n- `query`\n- `count`\n- `country`\n- `language`\n- `safeSearch`\n\n## How It Works\n\nThe provider calls:\n\n```http\nGET https://api.justserpapi.com/api/v1/google/search?query=...\nX-API-Key: \u003capiKey\u003e\n```\n\nIt maps JustSerpAPI `data.organic_results[]` into OpenClaw web search results:\n\n- `title`\n- `url`\n- `snippet`\n- `description`\n- `source`\n- `siteName`\n- `displayedLink`\n- `favicon`\n- `position`\n\n## Troubleshooting\n\n- `missing_justserpapi_api_key`: configure `plugins.entries.justserpapi.config.webSearch.apiKey` or set `JUSTSERPAPI_API_KEY`.\n- `401` or `403`: check that the API key is valid and the account has permission/credits.\n- `429`: the JustSerpAPI account is rate limited; retry later or adjust usage.\n- No `web_search` results: confirm `tools.web.search.provider` is set to `justserpapi` and the plugin is enabled.\n\n## Development\n\n```bash\nnpm install --omit=peer\nnpm test\nnpm run typecheck\nnpm pack --dry-run\n```\n\n`openclaw` is declared as an optional peer dependency so this package can be tested without vendoring the full OpenClaw runtime.\n\n## Security\n\nDo not commit real API keys. Use OpenClaw secret storage or environment variables for credentials.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustserpapi%2Fjustserpapi-openclaw-websearch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustserpapi%2Fjustserpapi-openclaw-websearch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustserpapi%2Fjustserpapi-openclaw-websearch/lists"}