{"id":17657388,"url":"https://github.com/unickcheng/search-sdk","last_synced_at":"2025-03-30T10:13:30.459Z","repository":{"id":99542549,"uuid":"601441014","full_name":"UNICKCHENG/search-sdk","owner":"UNICKCHENG","description":"A plugin that supports Google, Bing, Brave search ","archived":false,"fork":false,"pushed_at":"2023-12-03T20:31:05.000Z","size":52,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-05T12:11:17.147Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UNICKCHENG.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","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}},"created_at":"2023-02-14T04:10:55.000Z","updated_at":"2023-02-14T12:01:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"8aced5c8-ad8b-41e3-869d-d5b2f135e8d0","html_url":"https://github.com/UNICKCHENG/search-sdk","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNICKCHENG%2Fsearch-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNICKCHENG%2Fsearch-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNICKCHENG%2Fsearch-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNICKCHENG%2Fsearch-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UNICKCHENG","download_url":"https://codeload.github.com/UNICKCHENG/search-sdk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246301996,"owners_count":20755514,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-10-23T14:40:35.624Z","updated_at":"2025-03-30T10:13:30.425Z","avatar_url":"https://github.com/UNICKCHENG.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hi, there 👋\n\n`search-sdk` 是一款为 spring 开发者集成的插件，您可以使用它来从指定的搜索引擎中获取结果。\n\n**v0.0.1 版本功能比较单一，只能获取指定搜索引擎的至多 10 条搜索结果。**\n\n## ✨ 特征\n\n- [x] 基于 Playwright 模拟从 Brave、Google、Bing 获取搜索结果\n- [ ] 支持自定义获取搜索结果的数量、分页、导出\n- [ ] 集成 Bing API、Google API\n- [ ] 支持 自定义 Brave Goggles 搜索权重\n- [ ] 支持 DuckDuckgo 等更多的搜索引擎\n\n## 🎉 使用\n\n### 步骤 1: 增加依赖\n\n```pom.xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.github.unickcheng\u003c/groupId\u003e\n    \u003cartifactId\u003esearch-sdk\u003c/artifactId\u003e\n    \u003cversion\u003e0.0.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\u003e 注意当前还未提交到 Maven 中央仓库，因此您需要额外地添加下述镜像地址在您的 pom.xml 中\n```\n\u003crepositories\u003e\n    \u003crepository\u003e\n        \u003cid\u003eunickcheng\u003c/id\u003e\n        \u003curl\u003ehttps://unickcheng.github.io/maven-packages/\u003c/url\u003e\n    \u003c/repository\u003e\n\u003c/repositories\u003e\n```\n\n### 步骤2：创建 Bean\n\n```java\n@Bean\npublic SearchEngineService searchEngineService () {\n\treturn new SearchEngineService();\n}\n```\n\n\u003e? 如果您不知道如何开始使用，您可以参考 [spring-boot-demo](https://github.com/UNICKCHENG/search-sdk/tree/main/spring-boot-demo)\n\n### 如果您是前端人员\n\n您可以直接使用 [Playwright](https://www.npmjs.com/package/playwright) 官方提供的依赖，当然，您也可使用 [spring-boot-demo](https://github.com/UNICKCHENG/search-sdk/tree/main/spring-boot-demo) 作为现成的后端接口来使用。\n\n在启动后端项目之前，您需要确保已经配置好 `java 11` 和 `Maven 3.0+`。然后您需要到 spring-boot-demo 的目录下执行下述命令来运行项目。当然您也可以使用内存大户 IDEA。\n```bash\n# 下载所需依赖\nmvn install\n# 启动 spring boot 项目\nmvn spring-boot:run\n```\n\n\n## 为什么要创建这个项目\n\n去年 Brave 推出了 [Brave Goggles](https://search.brave.com/help/goggles)，这使得用户可以根据自己的需求来自定义搜索权重。打个比方，如果您是一名学术工作者，您可以为 Wikipedia、Google Scholar、connectedpapers 等网站增加相应的权重，这样将使得和这些网站相关的搜索结果更加靠前。\n\n于是，我开始尝试能不能将它集成到 wechat 中去，像 telegram、discord 那样通过斜杆命令，直接获取相应的搜索结果。遗憾的是，Brave 官方似乎并没有像 Google 和 Bing 一样提供 API，虽然有 [SerpApi](https://serpapi.com/) 这类第三方接口，但是对于个人开发者来说并不太友善。\n\n既然如此，那只能造个轮子呗~\n\n## 💖 感谢\n\n- https://playwright.dev/\n- [Spring Boot](https://spring.io/projects/spring-boot) provides framework support\n- [Open Source Dependencies](https://github.com/UNICKCHENG/search-sdk/network/dependencies) provides support\n- Thanks to all open source projects for sharing ideas and techniques\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funickcheng%2Fsearch-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funickcheng%2Fsearch-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funickcheng%2Fsearch-sdk/lists"}