Add MAL Articles

[irfan-dahir]

This implements 6 new API endpoints and refactors how the news parser works.
Feature Tracker: #491

To do

• getPinnedArticles
• getRecentArticles
• getArticlesByTag
• getArticleTags
• getArticleSearch
• getArticle
• Unit Tests

---

getPinnedArticles

Description: Retrieves the pinned featured article listing
URL: https://myanimelist.net/featured

API Request:

(new \Jikan\MyAnimeList\MalClient())
    ->getPinnedArticles(
        new \Jikan\Request\Article\PinnedArticlesRequest()
    );

REST API Remarks: Cache this. It's just 4 entries.

getRecentArticles

Description: Retrieves the latest featured article listing
URL: https://myanimelist.net/featured?p=1

API Request:

(new \Jikan\MyAnimeList\MalClient())
    ->getRecentArticles(
        new \Jikan\Request\Article\RecentArticleRequest(1)
    );

REST API Remarks: It would probably be best to use this method to loop through each ID, fetch their details via getArticles and index/populate them directly into MongoDB/TypeSense. This would allow us to provide a better search experience.

getArticlesByTag

Description: Retrieves article listing by tag
URL: https://myanimelist.net/featured/tag/interview

API Request:

(new \Jikan\MyAnimeList\MalClient())
    ->getArticlesByTag(
        new \Jikan\Request\Article\ArticlesByTagRequest('interview', 1)
    );

REST API Remarks: Won't need this scraper API call on the REST API because we'll have custom search.

getArticleSearch

Description: Retrieves article listing by query
URL: https://myanimelist.net/featured/search?q=test&p=1

API Request:

(new \Jikan\MyAnimeList\MalClient())
    ->getArticleSearch(
        new \Jikan\Request\Search\ArticleSearchRequest('test', 1)
    );

REST API Remarks: Won't need this scraper API call on the REST API because we'll have custom search.

getArticleTags

Description: Retrieves all article tags
URL: https://myanimelist.net/featured/tag

API Request:

(new \Jikan\MyAnimeList\MalClient())
    ->getArticleTags(
        new \Jikan\Request\Article\ArticleTagsRequest()
    );

REST API Remarks: Periodic sync and overwrite like we have for Anime and Manga Genres. There are many entries so we could paginate, provide basic name search (use case: auto completion).

getArticle

Description: Retrieves article resource
URL: https://myanimelist.net/featured/1

API Request:

(new \Jikan\MyAnimeList\MalClient())
    ->getArticle(
        new \Jikan\Request\Article\ArticleRequest(1)
    );

REST API Remarks: We'll use a periodic sync strategy with getRecentNews to get all new entries in one go and keep them updated as there may be a chance of articles being edited later on. Perhaps biweekly or once a month?

[github-actions]

This pull request will be closed and archived in 18 days, as there has been no activity in the last 60 days. If this is still being worked on, please respond and we will re-open this pull request.