https://github.com/yrq110/TinyGoogle

A search web app built by Flask and Google CSE
https://github.com/yrq110/TinyGoogle

flask google-cse

Last synced: about 2 months ago
JSON representation

A search web app built by Flask and Google CSE

• Host: GitHub
• URL: https://github.com/yrq110/TinyGoogle
• Owner: yrq110
• License: mit
• Created: 2016-11-07T11:06:27.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2023-01-29T09:14:36.000Z (over 1 year ago)
• Last Synced: 2024-05-03T06:21:14.750Z (5 months ago)
• Topics: flask, google-cse
• Language: Python
• Homepage:
• Size: 186 KB
• Stars: 183
• Watchers: 17
• Forks: 59
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# TinyGoogle

TinyGoogle built with Flask + Bootstrap + Google CSE

Live Demo: http://tinygoo.herokuapp.com




  

    

  



> Note: the demo may need some spin up time if nobody has accessed it for a certain period.

## Features

* Search content by Google Custom Search API

* Ignore [GFW](https://en.wikipedia.org/wiki/Great_Firewall) to use google search

## Search Times

There are 4 engines in this demo. Each engine can search 100 times/day.

If the demo run out of search times when you use, please try just another day.

## Requirements

* python 3.5

* flask 0.11.1

* gunicorn 19.6.0

* requests 2.12.1

* flask-bootstrap 3.3.7.0

## Build Setup

1. install requirements

  ```bash

  pip install -r requirements.txt

  ```

2. run

  ```bash

  gunicorn app:app  

  # server at http://127.0.0.1:8000

  ```

## Config

1. in `data/engine.json`, you can change&add the engine's `key` and `cx` values:

  ```

    {

      "YOUR_ENGINE":{

        "name":"YOUR_NAME",

        "key":"YOUR_API_KEY",

        "cx":"YOUR_ENGINE_ID"

      }

    },

  ```

2. where to get CSE ID and Google API key :

  [Google CSE](https://cse.google.com/) & [Google API Console](https://console.developers.google.com/)

## Todo

* -[x] update to python3

* -[x] thumbnail switch

* -[ ] doodle

## License

TinyGoogle is licensed under [MIT](http://opensource.org/licenses/MIT)