asimov-serpapi-module 0.1.1-x86_64-linux-gnu

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d9a5053128ec7ee4640d87d3c02610f5f470c73817b5a91007d269ea28eff167
+  data.tar.gz: b693028f33c903b4400392ff4880de09d88abb3446074540bf3c1c7dcfbfa925
+SHA512:
+  metadata.gz: d877f59a657437e47adee64e19b07c2a48e9340418ee36622d94de158ea79fccd95ba84047d77dff6a22790aff743ed6448dc7520a1d591be0cf204003547ec6
+  data.tar.gz: 23252d4617cafe2f643f92409833472d2f32a1b423e13311710e895d20177c2d022d3f647360bc2d21031fc82462f5c497a5ee92c2f2737f7d41249c1af38255

data/AUTHORS

@@ -0,0 +1 @@
+* Arto Bendiken <arto@asimov.so>

data/CHANGES.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 0.1.1 - 2025-05-29
+### Changed
+- Build releases automatically
+
+## 0.1.0 - 2025-05-24
+### Added
+- Pretty-printed JSON & JSON-LD output
+
+## 0.0.1 - 2025-05-22
+
+## 0.0.0 - 2025-05-21

data/README.md

@@ -0,0 +1,121 @@
+# ASIMOV SerpApi Module
+
+[![License](https://img.shields.io/badge/license-Public%20Domain-blue.svg)](https://unlicense.org)
+[![Package on Crates.io](https://img.shields.io/crates/v/asimov-serpapi-module.svg)](https://crates.io/crates/asimov-serpapi-module)
+[![Package on PyPI](https://img.shields.io/pypi/v/asimov-serpapi-module.svg)](https://pypi.org/project/asimov-serpapi-module)
+[![Package on RubyGems](https://img.shields.io/gem/v/asimov-serpapi-module.svg)](https://rubygems.org/gems/asimov-serpapi-module)
+[![Package on NPM](https://img.shields.io/npm/v/asimov-serpapi-module.svg)](https://npmjs.com/package/asimov-serpapi-module)
+
+[ASIMOV] module for data import powered by the [SerpApi] search data platform.
+
+## ✨ Features
+
+- Imports structured data from DuckDuckGo, Google, and Bing search results.
+- Collects the raw JSON data via the SerpApi real-time API (requires an API key).
+- Constructs a semantic knowledge graph based on the [KNOW] ontology.
+- Supports plain JSON output as well as [RDF] output in the form of [JSON-LD].
+- Distributed as a standalone static binary with zero runtime dependencies.
+
+## 🛠️ Prerequisites
+
+- [Rust] 1.85+ (2024 edition) if building from source code
+
+## ⬇️ Installation
+
+### Installation from PyPI
+
+```bash
+pip install -U asimov-serpapi-module
+```
+
+### Installation from RubyGems
+
+```bash
+gem install asimov-serpapi-module
+```
+
+### Installation from NPM
+
+```bash
+npm install -g asimov-serpapi-module
+```
+
+### Installation from Source Code
+
+```bash
+cargo install asimov-serpapi-module
+```
+
+## 👉 Examples
+
+```bash
+export SERPAPI_KEY="..."
+```
+
+### Fetching DuckDuckGo Results
+
+```bash
+asimov-serpapi-fetcher https://duckduckgo.com/?q=Isaac+Asimov   # JSON
+asimov-serpapi-importer https://duckduckgo.com/?q=Isaac+Asimov  # JSON-LD
+```
+
+### Fetching Google Results
+
+```bash
+asimov-serpapi-fetcher https://www.google.com/search?q=Isaac+Asimov   # JSON
+asimov-serpapi-importer https://www.google.com/search?q=Isaac+Asimov  # JSON-LD
+```
+
+### Fetching Bing Results
+
+```bash
+asimov-serpapi-fetcher https://www.bing.com/search?q=Isaac+Asimov   # JSON
+asimov-serpapi-importer https://www.bing.com/search?q=Isaac+Asimov  # JSON-LD
+```
+
+## ⚙ Configuration
+
+### Environment Variables
+
+- `SERPAPI_KEY`: (required) the [SerpApi API key] to use
+
+## 📚 Reference
+
+### Installed Binaries
+
+- `asimov-serpapi-fetcher`: collects JSON data from the SerpApi real-time API
+- `asimov-serpapi-importer`: collects and transforms JSON into JSON-LD
+
+### Supported Engines
+
+Engine  | URL Prefix | JSON | RDF
+:------ | :--------- | :--: | :--:
+Bing | `https://www.bing.com/search?q=` | ✅ | ✅
+DuckDuckGo | `https://duckduckgo.com/?q=` | ✅ | ✅
+Google | `https://www.google.com/search?q=` | ✅ | ✅
+<img width="100" height="1"/> | <img width="550" height="1"/> | <img width="50" height="1"/> | <img width="50" height="1"/>
+
+## 👨‍💻 Development
+
+```bash
+git clone https://github.com/asimov-modules/asimov-serpapi-module.git
+```
+
+---
+
+[![Share on X](https://img.shields.io/badge/share%20on-x-03A9F4?logo=x)](https://x.com/intent/post?url=https://github.com/asimov-modules/asimov-serpapi-module&text=asimov-serpapi-module)
+[![Share on Reddit](https://img.shields.io/badge/share%20on-reddit-red?logo=reddit)](https://reddit.com/submit?url=https://github.com/asimov-modules/asimov-serpapi-module&title=asimov-serpapi-module)
+[![Share on Hacker News](https://img.shields.io/badge/share%20on-hn-orange?logo=ycombinator)](https://news.ycombinator.com/submitlink?u=https://github.com/asimov-modules/asimov-serpapi-module&t=asimov-serpapi-module)
+[![Share on Facebook](https://img.shields.io/badge/share%20on-fb-1976D2?logo=facebook)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/asimov-modules/asimov-serpapi-module)
+[![Share on LinkedIn](https://img.shields.io/badge/share%20on-linkedin-3949AB?logo=linkedin)](https://www.linkedin.com/sharing/share-offsite/?url=https://github.com/asimov-modules/asimov-serpapi-module)
+
+[ASIMOV]: https://github.com/asimov-platform
+[JSON-LD]: https://json-ld.org
+[KNOW]: https://github.com/know-ontology
+[NPM]: https:/npmjs.org
+[Python]: https://python.org
+[RDF]: https://github.com/rust-rdf
+[Ruby]: https://ruby-lang.org
+[Rust]: https://rust-lang.org
+[SerpApi]: https://serpapi.com
+[SerpApi API key]: https://serpapi-python.readthedocs.io/en/latest/#serpapi.Client

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org/>

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/bin/asimov-serpapi-fetcher

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+require_relative "../lib/asimov-serpapi-module"
+argv0 = ::ASIMOV_Serpapi_Module::Fetcher.path
+if ::Gem.win_platform?
+  ::Kernel.exit(::Kernel.system(argv0, *ARGV) ? 0 : $?.exitstatus)
+else
+  ::Kernel.exec(argv0, *ARGV)
+end

data/bin/asimov-serpapi-importer

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+require_relative "../lib/asimov-serpapi-module"
+argv0 = ::ASIMOV_Serpapi_Module::Importer.path
+if ::Gem.win_platform?
+  ::Kernel.exit(::Kernel.system(argv0, *ARGV) ? 0 : $?.exitstatus)
+else
+  ::Kernel.exec(argv0, *ARGV)
+end

data/lib/asimov-serpapi-module/fetcher.rb

@@ -0,0 +1,23 @@
+# This is free and unencumbered software released into the public domain.
+
+module ASIMOV_Serpapi_Module; end
+
+class ASIMOV_Serpapi_Module::Fetcher
+  def self.path
+    ::File.join(__dir__, "asimov-serpapi-fetcher")
+  end
+
+  def self.execute(...)
+    self.new(...).execute
+  end
+
+  def initialize(*args, env: {})
+    @argv0 = self.class.path.freeze
+    @args = args.map(&:to_s).freeze
+    @env = env.to_h.freeze
+  end
+
+  def execute(*args)
+    ::Kernel.system(@env, @argv0, *(@args + args.map(&:to_s))) ? 0 : $?.exitstatus
+  end
+end

data/lib/asimov-serpapi-module/importer.rb

@@ -0,0 +1,23 @@
+# This is free and unencumbered software released into the public domain.
+
+module ASIMOV_Serpapi_Module; end
+
+class ASIMOV_Serpapi_Module::Importer
+  def self.path
+    ::File.join(__dir__, "asimov-serpapi-importer")
+  end
+
+  def self.execute(...)
+    self.new(...).execute
+  end
+
+  def initialize(*args, env: {})
+    @argv0 = self.class.path.freeze
+    @args = args.map(&:to_s).freeze
+    @env = env.to_h.freeze
+  end
+
+  def execute(*args)
+    ::Kernel.system(@env, @argv0, *(@args + args.map(&:to_s))) ? 0 : $?.exitstatus
+  end
+end

data/lib/asimov-serpapi-module.rb

@@ -0,0 +1,8 @@
+# This is free and unencumbered software released into the public domain.
+
+module ASIMOV_Serpapi_Module
+  VERSION = "0.1.1".freeze
+end
+
+require_relative 'asimov-serpapi-module/fetcher'
+require_relative 'asimov-serpapi-module/importer'

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification
+name: asimov-serpapi-module
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: x86_64-linux-gnu
+authors:
+- ASIMOV Protocol
+bindir: bin
+cert_chain: []
+date: 2025-05-29 00:00:00.000000000 Z
+dependencies: []
+description: ASIMOV module for data import powered by the SerpApi search data platform.
+email: support@asimov.so
+executables:
+- asimov-serpapi-fetcher
+- asimov-serpapi-importer
+extensions: []
+extra_rdoc_files: []
+files:
+- AUTHORS
+- CHANGES.md
+- README.md
+- UNLICENSE
+- VERSION
+- bin/asimov-serpapi-fetcher
+- bin/asimov-serpapi-importer
+- lib/asimov-serpapi-module.rb
+- lib/asimov-serpapi-module/asimov-serpapi-fetcher
+- lib/asimov-serpapi-module/asimov-serpapi-importer
+- lib/asimov-serpapi-module/fetcher.rb
+- lib/asimov-serpapi-module/importer.rb
+homepage: https://github.com/asimov-modules
+licenses:
+- Unlicense
+metadata:
+  homepage_uri: https://github.com/asimov-modules
+  source_code_uri: https://github.com/asimov-modules/asimov-serpapi-module
+  changelog_uri: https://github.com/asimov-modules/asimov-serpapi-module/blob/master/CHANGES.md
+  bug_tracker_uri: https://github.com/asimov-modules/asimov-serpapi-module/issues
+  documentation_uri: https://github.com/asimov-modules/asimov-serpapi-module/blob/master/README.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: ASIMOV module for data import powered by the SerpApi search data platform.
+test_files: []