Sign inSign up

lalogo/man-go

By lalogo

•Updated over 3 years ago

Go RESTful API for search mangas, their chapters and pages from different websites simultaneously

Image
0

6.0K

lalogo/man-go repository overview

⁠Man-go

⁠Work in progress

GetMangasGetMangaPageGetChapter
In Manga✅✅✅
Nyaa✅✅✅
Manga Oni✅❌❌

⁠Run in Docker-compose

version: '3.8'
services:
    man-go:
        image: man-go
        ports:
        - "7070:7070"

⁠Clone and run the repository

  1. Clone the repository 
    git clone https://github.com/la-lo-go/man-go
  2. Create a new .env file in the root of the repository with the following scheme: 
    # API
API_IP="0.0.0.0"
API_PORT="7070"

# DB
DB_NAME="mango.sqlite3"
  3. Compile and run 
    go run main.go

⁠API responses

⁠Search
⁠Query
/busqueda?search=[search_string]&max=[int (optional)]
⁠Response
Example: /busqueda?search=jujutsu&max=1

[
    {
        "name": "jujutsu-kaisen",
        "site": "InManga",
        "link": "https://inmanga.com/ver/manga/Jujutsu-Kaisen/d88692a5-c341-47fc-8e39-da11a8fdee82",
        "chapters_number": 0,
        "cover": "https://pack-yak.intomanga.com/thumbnails/manga/Jujutsu-Kaisen/d88692a5-c341-47fc-8e39-da11a8fdee82"
    },
    {
        "name": "jujutsu-kaisen",
        "site": "Nyaa",
        "link": "https://manganyaa.com/jujutsu-kaisen/leer-online-gratis-espanol",
        "chapters_number": 99,
        "cover": "https://content.manganyaa.com/file/mnyaaa/jujutsu-kaisen/description/1.jpg"
    },
    {
        "name": "jujutsu-kaisen",
        "site": "TuManga.net",
        "link": "https://tumanga.net/manga/jujutsu-kaisen",
        "chapters_number": 99,
        "cover": ""
    }
]
⁠Manga Page
⁠Query
/manga/[site]/[manga_name]
⁠Response
Example: /manga/jujutsu-kaisen/nyaa

{
    "name": "Jujutsu Kaisen",
    "site": "Nyaa",
    "cover": "https://content.manganyaa.com/file/mnyaaa/jujutsu-kaisen/description/1.jpg",
    "chaptersNumber": 186,
    "chaptersListed": [
        {
            "number": 186,
            "linkOriginal": "https://manganyaa.com/jujutsu-kaisen/leer-online-gratis-espanol/capitulo/186"
        },
        {
            "number": 185,
            "linkOriginal": "https://manganyaa.com/jujutsu-kaisen/leer-online-gratis-espanol/capitulo/185"
        },
        ...
        {
            "number": 2,
            "linkOriginal": "https://manganyaa.com/jujutsu-kaisen/leer-online-gratis-espanol/capitulo/2"
        },
        {
            "number": 1,
            "linkOriginal": "https://manganyaa.com/jujutsu-kaisen/leer-online-gratis-espanol/capitulo/1"
        }
    ]
}

⁠Cache

  • searches table: all the results of the searches with the date.

    • The search is exact: the results are returned.
    • The has a key that is included in the search: the results are filtered.
    • Else: do a full search

  • API_linksMangas.json: JSON returned by the Nyaa API with all the mangas listed in the page. Has a 12 hour expire time.

⁠File structure

man-go
├───endpoints           <- endpoints functions
├───gorm                <- gorm database functions
├───general_functions   <- handy custom functions
├───json                <- cached information
├───models              <- api's structs
├───routers             <- gin-gonic router
└───sites               <- sites using the interface
    ├───inManga
    ├───mangaMx
    ├───nyaa
    └───tuMangaNet

⁠License

Mozilla Public License 2.0⁠

License: MPL 2.0

Tag summary

Content type

Image

Digest

sha256:c61527971…

Size

306.7 MB

Last updated

over 3 years ago

docker pull lalogo/man-go