articlealpha 0.1.0__tar.gz

articlealpha-0.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: articlealpha
+Version: 0.1.0
+Summary: Python client for ArticleAlpha Wikipedia-based market attention data.
+Home-page: https://github.com/articlealpha/articlealpha
+Author: ArticleAlpha
+Author-email: info@articlealpha.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: pandas
+Requires-Dist: requests
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# ArticleAlpha Python Client
+
+The official Python wrapper for the [ArticleAlpha](https://articlealpha.com) API. 
+
+ArticleAlpha tracks investor curiosity by monitoring Wikipedia pageview trends for thousands of global stocks. This library allows data scientists and analysts to pull that "Attention Data" directly into Pandas for behavioral finance research.
+
+## Installation
+
+```bash
+pip install articlealpha
+```
+
+### Usage
+
+```python
+from articlealpha import ArticleAlpha
+
+# Get daily time-series for all stocks
+df = ArticleAlpha.get_timeseries()
+print(df.head())
+
+# Get deep details for a specific ticker
+nvda = ArticleAlpha.get_ticker_details("NVDA")
+```
+
+## Data Source & Attribution
+
+This project utilizes data from the **Wikimedia Metrics API**.
+
+- **Source:** [Wikimedia API](https://doc.wikimedia.org/generated-data-platform/aqs/analytics-api/concepts/page-views.html)
+- **Trademark Notice:** Wikipedia® is a registered trademark of the Wikimedia Foundation, Inc. ArticleAlpha is an independent project and is not affiliated with or endorsed by the Wikimedia Foundation.
+
+## Disclaimer
+This data is for informational purposes only. ArticleAlpha does not provide investment advice. Wikipedia pageviews represent public interest and curiosity, which may or may not correlate with market performance.
+
+## License
+MIT

articlealpha-0.1.0/README.md

@@ -0,0 +1,37 @@
+# ArticleAlpha Python Client
+
+The official Python wrapper for the [ArticleAlpha](https://articlealpha.com) API. 
+
+ArticleAlpha tracks investor curiosity by monitoring Wikipedia pageview trends for thousands of global stocks. This library allows data scientists and analysts to pull that "Attention Data" directly into Pandas for behavioral finance research.
+
+## Installation
+
+```bash
+pip install articlealpha
+```
+
+### Usage
+
+```python
+from articlealpha import ArticleAlpha
+
+# Get daily time-series for all stocks
+df = ArticleAlpha.get_timeseries()
+print(df.head())
+
+# Get deep details for a specific ticker
+nvda = ArticleAlpha.get_ticker_details("NVDA")
+```
+
+## Data Source & Attribution
+
+This project utilizes data from the **Wikimedia Metrics API**.
+
+- **Source:** [Wikimedia API](https://doc.wikimedia.org/generated-data-platform/aqs/analytics-api/concepts/page-views.html)
+- **Trademark Notice:** Wikipedia® is a registered trademark of the Wikimedia Foundation, Inc. ArticleAlpha is an independent project and is not affiliated with or endorsed by the Wikimedia Foundation.
+
+## Disclaimer
+This data is for informational purposes only. ArticleAlpha does not provide investment advice. Wikipedia pageviews represent public interest and curiosity, which may or may not correlate with market performance.
+
+## License
+MIT

articlealpha-0.1.0/articlealpha/__init__.py

@@ -0,0 +1,4 @@
+from .client import ArticleAlpha
+
+__version__ = "0.1.0"
+__all__ = ["ArticleAlpha"]

articlealpha-0.1.0/articlealpha/client.py

@@ -0,0 +1,75 @@
+import pandas as pd
+import requests
+import io
+
+class ArticleAlpha:
+    """Client for the ArticleAlpha Market Attention API."""
+    
+    BASE_URL = "https://articlealpha.com/api/v1"
+    
+    HEADERS = {
+        "User-Agent": "ArticleAlpha-Client/0.1 (Mozilla/5.0 compatible; DataScience/1.0)"
+    }
+
+    @classmethod
+    def _fetch(cls, endpoint):
+        """Internal helper to fetch URL with proper headers."""
+        url = f"{cls.BASE_URL}{endpoint}"
+        response = requests.get(url, headers=cls.HEADERS)
+        
+        if response.status_code == 403:
+            raise ConnectionError(
+                "403 Forbidden"
+                "The server might be under high load or blocking scripts."
+            )
+        elif response.status_code != 200:
+            raise ConnectionError(f"API Error {response.status_code}: {url}")
+            
+        return response
+
+    @classmethod
+    def get_timeseries(cls):
+        """
+        Fetches the bulk daily time-series for all tracked stocks.
+        Returns:
+            pd.DataFrame: Columns [Ticker, Date, Raw Views, Smoothed Views, Baseline, Multiplier, Edits]
+        """
+        try:
+            # 1. Fetch raw CSV text with headers
+            response = cls._fetch("/market/timeseries.csv")
+            
+            # 2. Parse string into DataFrame
+            df = pd.read_csv(io.StringIO(response.text))
+            
+            if 'Date' in df.columns:
+                df['Date'] = pd.to_datetime(df['Date'])
+            return df
+            
+        except Exception as e:
+            raise ConnectionError(f"Failed to fetch data from ArticleAlpha API: {e}")
+
+    @classmethod
+    def get_summary(cls):
+        """
+        Fetches the latest market snapshot/heatmap data.
+        Returns:
+            pd.DataFrame: Latest metrics for all symbols.
+        """
+        try:
+            response = cls._fetch("/market/summary.json")
+            return pd.DataFrame(response.json())
+        except Exception as e:
+            raise ConnectionError(f"Failed to fetch summary from ArticleAlpha API: {e}")
+
+    @classmethod
+    def get_ticker_details(cls, symbol):
+        """
+        Fetches deep metadata and related pages for a specific stock.
+        Args:
+            symbol (str): The stock ticker (e.g., 'AAPL')
+        """
+        try:
+            response = cls._fetch(f"/ticker/{symbol.upper()}.json")
+            return response.json()
+        except:
+            return None

articlealpha-0.1.0/articlealpha.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: articlealpha
+Version: 0.1.0
+Summary: Python client for ArticleAlpha Wikipedia-based market attention data.
+Home-page: https://github.com/articlealpha/articlealpha
+Author: ArticleAlpha
+Author-email: info@articlealpha.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: pandas
+Requires-Dist: requests
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# ArticleAlpha Python Client
+
+The official Python wrapper for the [ArticleAlpha](https://articlealpha.com) API. 
+
+ArticleAlpha tracks investor curiosity by monitoring Wikipedia pageview trends for thousands of global stocks. This library allows data scientists and analysts to pull that "Attention Data" directly into Pandas for behavioral finance research.
+
+## Installation
+
+```bash
+pip install articlealpha
+```
+
+### Usage
+
+```python
+from articlealpha import ArticleAlpha
+
+# Get daily time-series for all stocks
+df = ArticleAlpha.get_timeseries()
+print(df.head())
+
+# Get deep details for a specific ticker
+nvda = ArticleAlpha.get_ticker_details("NVDA")
+```
+
+## Data Source & Attribution
+
+This project utilizes data from the **Wikimedia Metrics API**.
+
+- **Source:** [Wikimedia API](https://doc.wikimedia.org/generated-data-platform/aqs/analytics-api/concepts/page-views.html)
+- **Trademark Notice:** Wikipedia® is a registered trademark of the Wikimedia Foundation, Inc. ArticleAlpha is an independent project and is not affiliated with or endorsed by the Wikimedia Foundation.
+
+## Disclaimer
+This data is for informational purposes only. ArticleAlpha does not provide investment advice. Wikipedia pageviews represent public interest and curiosity, which may or may not correlate with market performance.
+
+## License
+MIT

articlealpha-0.1.0/articlealpha.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+setup.py
+articlealpha/__init__.py
+articlealpha/client.py
+articlealpha.egg-info/PKG-INFO
+articlealpha.egg-info/SOURCES.txt
+articlealpha.egg-info/dependency_links.txt
+articlealpha.egg-info/requires.txt
+articlealpha.egg-info/top_level.txt

articlealpha-0.1.0/articlealpha.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

articlealpha-0.1.0/articlealpha.egg-info/requires.txt

@@ -0,0 +1,2 @@
+pandas
+requests

articlealpha-0.1.0/articlealpha.egg-info/top_level.txt

@@ -0,0 +1 @@
+articlealpha

articlealpha-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

articlealpha-0.1.0/setup.py

@@ -0,0 +1,24 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="articlealpha",
+    version="0.1.0",
+    author="ArticleAlpha",
+    author_email="info@articlealpha.com",
+    description="Python client for ArticleAlpha Wikipedia-based market attention data.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/articlealpha/articlealpha",
+    packages=find_packages(),
+    install_requires=[
+        "pandas",
+        "requests",
+    ],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Topic :: Office/Business :: Financial :: Investment",
+    ],
+    python_requires='>=3.6',
+)