https://github.com/d-salazar-se/stare.js-server
StArE.js Server version
https://github.com/d-salazar-se/stare.js-server
node node-js nodejs npm npm-package npmjs serp
Last synced: 3 months ago
JSON representation
StArE.js Server version
- Host: GitHub
- URL: https://github.com/d-salazar-se/stare.js-server
- Owner: d-salazar-se
- License: mit
- Created: 2019-12-24T05:34:05.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-05T09:58:22.000Z (over 3 years ago)
- Last Synced: 2025-02-25T13:54:12.970Z (over 1 year ago)
- Topics: node, node-js, nodejs, npm, npm-package, npmjs, serp
- Language: JavaScript
- Homepage: https://starejs.informatica.usach.cl/
- Size: 1.16 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# StArE.js (Node.js Server version)
[](https://travis-ci.com/d-salazar-se/stare.js-server)
[](https://coveralls.io/github/d-salazar-se/stare.js-server?branch=master)
## Description
StArE.js is an open source project intended to facilitate developers the creation of alternative visualizations of search engine results page (SERP). StArE.js provides a modular and extensible processing pipeline capable of (1) transforming SERP, (2) extracting features from individual search results, and (3) visualizing SERP in multiple ways.
## Installation
```bash
npm install stare.js
```
## How to use
```js
const stare = require('stare.js')(...options);
// stare(searchEngine = '', query = '', pageNumber = 1, metrics = []);
stare('google', 'What is love?', 1, ['ranking', 'language'])
.then(result => {
console.log(result);
})
.catch(err => {
console.error(err);
});
```
You can find the most basic full example in the [examples folder](/examples/).
## Resources
* [npm package](https://www.npmjs.com/package/stare.js)
* [Documentation](/docs/)
* [Examples](/examples/)
## Extensions
StArE.js is currently extended with the following plugins:
| SERP | Function name | Description | Documentation |
| ------ | ------ | ------ | ------ |
| Google | google | Handler for SERPs obtained through the Google Custom Search JSON API | [See docs](/docs/SERP.md#google) |
| Bing | bing | Handler for SERPs obtained through the Bing web search API | [See docs](/docs/SERP.md#bing) |
| Ecosia | ecosia | Handler for SERPs obtained from ecosia through a web scrapper | [See docs](/docs/SERP.md#ecosia) |
| ElasticSearch | elasticsearch | Handler for SERPs obtained from ElasticSearch (only basic support) via request-promise | [See docs](/docs/SERP.md#elasticsearch) |
| Metrics | Metric name | Description | Documentation |
| ------ | ------ | ------ | ------ |
| Perspicuity | perspicuity | Reading Ease for English and Perspicuity for Spanish | [See docs](/docs/METRICS.md#perspicuity) |
| Language | language | Detect the most probable language for a document | [See docs](/docs/METRICS.md#language) |
| Length of Documents | length | Calculate the length in characters of a Document | [See docs](/docs/METRICS.md#length) |
| Ranking | ranking | Calculate the length in characters of a Document | [See docs](/docs/METRICS.md#ranking) |
As is explained in the docs you can create your own extensions for [SERP](/docs/SERP.md#create-your-own-extensions) and [metrics](/docs/METRICS.md#create-your-own-extensions) support.
Please see the full documentation [here](/docs/INDEX.md).
## Debug / Logging
StArE.js is powered by [debug](https://github.com/visionmedia/debug).
In order to see all the debug output, run your app with the environment variable
`DEBUG` including the desired scope.
To see the output from all of StArE.js's debugging scopes you can use:
```
DEBUG=stare.js
```
## Contributors
- [Roberto González-Ibáñez](https://github.com/rgonzal/)
- [Camila Márquez](https://github.com/bellyster/)
- [Daniel Gacitúa](https://github.com/dgacitua/)
- [Franz Farbinger](https://github.com/DarkAnimat/)
- [Diego Salazar S.](https://github.com/d-salazar-se/)
## License
[MIT](LICENSE)
## Todo
- Documentation
- More examples
- Travis-CI integration
- Test script
- metrics/perspicuity Support for languages other than ['en-us', 'es', 'fr']
- personal SERP support (like metrics)