search-web-api 1.0.200 → 1.0.202
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -33
- package/package.json +1 -1
- package/CLAUDE.md +0 -31
package/README.md
CHANGED
|
@@ -1,36 +1,29 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<img width="300px" src="https://i.imgur.com/BmaDQeR.png" />
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
<a href="https://
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
<
|
|
14
|
-
<a href="https://
|
|
15
|
-
<
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
<a href="https://github.com/
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
<img src="https://img.shields.io/github/last-commit/
|
|
22
|
-
<br />
|
|
23
|
-
<
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
<a href="https://codespaces.new/vtempest/qwksearch-research-agent">
|
|
28
|
-
<img src="https://github.com/codespaces/badge.svg" width="150" height="20" />
|
|
29
|
-
</a>
|
|
30
|
-
<a href="https://codecov.io/gh/OpenSourceAGI/qwksearch-research-agent"><img src="https://codecov.io/gh/OpenSourceAGI/qwksearch-research-agent/graph/badge.svg?component=package-search-web-api" alt="Coverage" /></a>
|
|
31
|
-
</p>
|
|
32
|
-
|
|
33
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img width="300px" src="https://i.imgur.com/BmaDQeR.png" />
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<!-- template-git-repo:badges:start -->
|
|
6
|
+
<p align="center">
|
|
7
|
+
<a href="https://qwksearch.com/api/docs"><img src="https://img.shields.io/badge/Docs-blue?logo=ReadTheDocs&logoColor=white" alt="Documentation" /></a>
|
|
8
|
+
<a href="https://stackblitz.com/github/OpenSourceAGI/qwksearch-research-agent/tree/master/packages/search-web-api"><img height="20px" src="https://developer.stackblitz.com/img/open_in_stackblitz.svg" alt="Open in StackBlitz" /></a>
|
|
9
|
+
<br />
|
|
10
|
+
<a href="https://www.npmjs.com/package/search-web-api"><img src="https://img.shields.io/npm/dm/search-web-api.svg" alt="NPM Monthly Downloads" /></a>
|
|
11
|
+
<a href="https://www.npmjs.com/package/search-web-api"><img src="https://img.shields.io/npm/v/search-web-api.svg" alt="npm version" /></a>
|
|
12
|
+
<a href="https://www.npmjs.com/package/search-web-api"><img src="https://img.shields.io/npm/dt/search-web-api.svg" alt="NPM Total Downloads" /></a>
|
|
13
|
+
<a href="https://www.npmjs.com/package/search-web-api"><img src="https://img.shields.io/npm/types/search-web-api" alt="TypeScript types" /></a>
|
|
14
|
+
<a href="https://packagephobia.com/result?p=search-web-api"><img src="https://packagephobia.com/badge?p=search-web-api" alt="Install size" /></a>
|
|
15
|
+
<br />
|
|
16
|
+
<a href="https://github.com/OpenSourceAGI/qwksearch-research-agent/stargazers"><img src="https://img.shields.io/github/stars/OpenSourceAGI/qwksearch-research-agent" alt="GitHub Stars" /></a>
|
|
17
|
+
<a href="https://github.com/OpenSourceAGI/qwksearch-research-agent/issues"><img src="https://img.shields.io/github/issues/OpenSourceAGI/qwksearch-research-agent?logo=github" alt="GitHub Issues" /></a>
|
|
18
|
+
<a href="https://github.com/OpenSourceAGI/qwksearch-research-agent/pulls"><img src="https://img.shields.io/github/issues-pr/OpenSourceAGI/qwksearch-research-agent?logo=github&label=PRs" alt="Open Pull Requests" /></a>
|
|
19
|
+
<a href="https://github.com/OpenSourceAGI/qwksearch-research-agent/pulls?q=is%3Apr+is%3Aclosed"><img src="https://img.shields.io/github/issues-pr-closed/OpenSourceAGI/qwksearch-research-agent?logo=github&label=PRs%20merged&color=8957e5" alt="Merged Pull Requests" /></a>
|
|
20
|
+
<a href="https://github.com/OpenSourceAGI/qwksearch-research-agent/discussions"><img src="https://img.shields.io/github/discussions/OpenSourceAGI/qwksearch-research-agent" alt="GitHub Discussions" /></a>
|
|
21
|
+
<a href="https://github.com/OpenSourceAGI/qwksearch-research-agent/commits/master/"><img src="https://img.shields.io/github/last-commit/OpenSourceAGI/qwksearch-research-agent.svg" alt="GitHub last commit" /></a>
|
|
22
|
+
<br />
|
|
23
|
+
<img src="https://img.shields.io/badge/Bun-14151A?logo=bun&logoColor=white" alt="Bun" /> <img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white" alt="TypeScript" /> <img src="https://img.shields.io/badge/Hono-E36002?logo=hono&logoColor=white" alt="Hono" /> <img src="https://img.shields.io/badge/Vitest-6E9F18?logo=vitest&logoColor=white" alt="Vitest" />
|
|
24
|
+
</p>
|
|
25
|
+
<!-- template-git-repo:badges:end -->
|
|
26
|
+
|
|
34
27
|
# Meta-Search Web Sources API
|
|
35
28
|
|
|
36
29
|
- **Multi-engine aggregation**: 70+ major sites search sources across 10 categories
|
package/package.json
CHANGED
package/CLAUDE.md
DELETED
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
# CLAUDE.md — `search-web-api`
|
|
2
|
-
|
|
3
|
-
**Read [`skills/ask-search-web-api`](../../skills/ask-search-web-api/SKILL.md)
|
|
4
|
-
and its `API.md` first.**
|
|
5
|
-
|
|
6
|
-
70+ search engines across 10 categories, plus dedupe and ranking. Published.
|
|
7
|
-
|
|
8
|
-
## Engine adapters are the bulk of this package
|
|
9
|
-
|
|
10
|
-
- **One adapter per engine, isolated.** An engine that changes its HTML or
|
|
11
|
-
starts rate-limiting must degrade to "this engine returned nothing", never
|
|
12
|
-
take down the query. Failure of one adapter is normal operation.
|
|
13
|
-
- **Never let an engine's markup reach a consumer unsanitized.** Results are
|
|
14
|
-
scraped HTML from arbitrary sites.
|
|
15
|
-
- Dedupe and ranking are what make 70 engines useful rather than noisy. A change
|
|
16
|
-
to either reorders results for every user — pin the behaviour in a test and
|
|
17
|
-
say so in the PR.
|
|
18
|
-
- `domain-rank` supplies source labels, rank and favicons; don't reimplement
|
|
19
|
-
them here.
|
|
20
|
-
|
|
21
|
-
## Rules
|
|
22
|
-
|
|
23
|
-
- Adding an engine: a new adapter plus its category, nothing else.
|
|
24
|
-
- Respect robots/ToS and rate limits — this is a polite client, not a scraper
|
|
25
|
-
race.
|
|
26
|
-
- Tests must not depend on a live engine returning particular results. Use
|
|
27
|
-
fixtures.
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
cd packages/search-web-api && bun run test
|
|
31
|
-
```
|