Skip to main content

Computational tools for anthropological and qualitative research: data collection and analysis as an MCP server and Python package

Project description

AI Anthropology Toolkit

A suite of AI anthropology tools for qualitative research

Matt Artz | GitHub | ORCID


Overview

The AI Anthropology Toolkit provides computational tools for anthropological and qualitative research. Every component is grounded in the conventions, debates, and craft knowledge of anthropology and cognate qualitative social sciences. Epistemic stance (interpretivist, critical, STS, feminist, applied, etc.) is treated as a first-class design parameter that shapes methods, writing, and analysis.

The toolkit includes standalone notebooks for qualitative data analysis, a Claude Code plugin with research lifecycle skills and agents, and will expand to include MCP servers and additional components over time.

What is AI Anthropology?

AI Anthropology is an emerging field that combines:

  • Studying AI as cultural artifact — Understanding how AI systems reflect and shape human culture
  • Using AI to enhance ethnographic research — Leveraging computational methods to scale qualitative analysis
  • Applying anthropological insights to AI development — Bringing cultural understanding to technology design

This toolkit focuses on the second aspect: using AI to enhance traditional anthropological research methods while preserving the interpretive frameworks that make the discipline unique.

Notebooks

Standalone notebooks for computational qualitative analysis. Most can be run directly in Google Colab. Notebooks marked Local should be run on your own machine (see Running Locally below).

Notebook Run Description
Academic Literature Explorer Open In Colab Search 250M+ scholarly works across all disciplines via OpenAlex with citation counts and open access detection
Qualitative Codebook Builder Open In Colab Build qualitative codebooks from source literature with AI-assisted code generation, validation, and structured export
Interview Transcript Semantic Chunker Open In Colab Segment interview transcripts into semantically coherent chunks with speaker-aware processing and coherence scoring — fully local, no API key required
Coding and Thematic Analysis Open In Colab Apply codes to qualitative data and build themes using deductive, inductive, or hybrid approaches, with multi-lens parallel analysis and cross-lens comparison
Text Network Analysis Open In Colab Build co-occurrence networks from text with community detection, centrality metrics, and interactive visualization
Topic Modeling (BERTopic) Open In Colab Discover topics in text collections using transformer-based clustering with interactive visualizations and zero-shot mode
Named Entity Recognition (GLiNER2) Open In Colab Extract people, places, organizations, concepts, and custom entity types from text using zero-shot NER
Google Books Ngram Explorer Open In Colab Analyze historical word frequency patterns across Google Books corpora (1800-2022) with visualization and export
Google Trends Explorer Open In Colab Retrieve and visualize Google Trends data with multi-term comparison, regional breakdowns, and related queries
Google News Explorer Open In Colab Search Google News by keyword, time period, and country with quick or extended date-range modes
Google Scholar Explorer Local Search Google Scholar for publications with year filtering, citation counts, and structured export
PubMed Literature Harvester Open In Colab Search PubMed and enrich results with metadata from CrossRef, OpenAlex, and Semantic Scholar
Google Patents Explorer Open In Colab Search Google Patents for patent metadata including titles, inventors, assignees, and filing dates
YouTube Video Search Open In Colab Search YouTube and export video metadata including titles, channels, views, and durations
YouTube Transcript Fetcher Open In Colab Fetch YouTube video transcripts with language selection, segment chunking, and multiple export formats
Podcast RSS Explorer Open In Colab Pull episode metadata from any podcast RSS feed with titles, dates, durations, and structured export

Skills

Claude Code skills that activate automatically based on context. Requires the AI Anthropology Toolkit plugin installed in Claude Code.

Skill Description
research-question Five-slot question grammar, evaluation rubric, genre conventions
methodology-selection Method-stance compatibility, evidence need decomposition, multi-method design
research-plan Ten-section plan architecture covering problem through feasibility
irb-protocol 13-section protocol narratives, risk assessment, digital ethnography ethics
informed-consent Consent modes (written, verbal, layered, community-based), cultural adaptation
grant-proposal NSF CA-DDRIG, Wenner-Gren, Fulbright, ERC, SSHRC, Wellcome — funder-specific guidance
dissertation-prospectus Section-by-section prospectus development (8-30 pages)
fieldwork-methods Interview guides, observation protocols, sampling strategies, data management plans
qualitative-analysis Codebook development, deductive/inductive/hybrid coding, thematic analysis, multi-lens comparison
research-writing Article architecture, ethnographic craft, subfield conventions, journal requirements
academic-review Peer review writing, rebuttal letters, revision strategy
conference-materials AAA abstracts, slide decks, posters, speaker notes, oral delivery
public-engagement Op-eds, blog posts, policy briefs, community reports, media preparation
job-materials Academic CVs, cover letters, job talks, application strategy
career-statements Research, teaching, and diversity statements; tenure narratives
teaching-materials Syllabi, lesson plans, assignments, rubrics, discussion guides

Agents

Autonomous Claude Code subagents that orchestrate across multiple skills for complex, multi-step tasks.

Agent Description
research-design Orchestrates question, methodology, and plan skills for end-to-end research design
ethics-reviewer Reviews research designs for ethics issues, drafts protocols and consent documents
proposal-advisor Translates research designs into persuasive funder-specific narratives
fieldwork-advisor Designs instruments tailored to specific research questions and fieldwork contexts
analysis-advisor Guides qualitative coding, codebook development, and thematic analysis
writing-advisor Guides article/chapter writing and R&R management
dissemination-advisor Handles register translation between academic and public audiences
career-advisor Coordinates application packages and course design

Commands

Command Description
/ai-anthropology:new-project Scaffold a new research project through guided phases
/ai-anthropology:skills List the toolkit's skills, agents, and commands

MCP Server

The toolkit also ships as a Python package (ai-anthropology-toolkit on PyPI) with an MCP server, so Claude (and other MCP clients) can drive the full analysis pipeline conversationally — scholarly search, transcript chunking, lens-configured codebook generation, qualitative coding with per-code validation, thematic analysis, and cross-lens comparison.

Installing the Claude Code plugin (above) bundles the server automatically. To register it anywhere else:

claude mcp add ai-anthropology -- uvx --from "ai-anthropology-toolkit[data]==2.1.0" ai-anthro-mcp

With ANTHROPIC_API_KEY set, analysis runs autonomously (api mode); without it, the orchestrating model performs each interpretive step itself through validated work packets (delegated mode), keeping every coding decision visible to the researcher.

Getting Started

Notebooks (Colab)

Click any Open in Colab badge above to run a notebook directly in your browser. Each notebook handles its own dependencies — no local installation needed.

Running Locally

Some notebooks (marked Local in the table) need to be run on your own machine. This requires Python and Jupyter.

If you already have Anaconda/Miniconda installed:

pip install scholarly
jupyter notebook

Then open the notebook file from the Jupyter file browser.

If you need to install Jupyter from scratch:

pip install jupyter scholarly
jupyter notebook

Notebooks that run locally will install any other dependencies they need automatically when you run the first cell.

Claude Code Plugin

Install the plugin in Claude Code:

/plugin marketplace add MattArtzAnthro/AI-Anthropology-Toolkit
/plugin install ai-anthropology@ai-anthropology

Skills activate automatically when Claude detects relevant context. Agents handle multi-step tasks across skills. Commands are invoked with slash syntax.

License

This repository — notebooks, Python package, MCP server, plugin content, and documentation — is licensed under the PolyForm Noncommercial License 1.0.0: free for noncommercial use, including research, education, and work by nonprofit and government research organizations, with attribution to Matt Artz appreciated. For commercial licensing, contact Matt Artz.

Citation

If you use this toolkit in your academic research, please cite:

Artz, Matt. 2025. AI Anthropology Toolkit. Software. Zenodo. https://doi.org/10.5281/zenodo.16728812

References

Artz, Matt. 2023. From Machine Learning to Machine Knowing: A Digital Anthropology Approach for the Machine Interpretation of Cultures. UNESCO. https://unesdoc.unesco.org/ark:/48223/pf0000384902.

Artz, Matt. 2023. "Ten Predictions for AI and the Future of Anthropology." Anthropology News, May 8. https://doi.org/10.1111/AN.1605.

Artz, Matt. 2026. "Artificial Intelligence: The AI Anthropology Lifecycle (of, by, for AI)." In Practicing Digital Ethnography, edited by Devin Proctor. Routledge. https://doi.org/10.4324/9781032672663-29.

Artz, Matt. 2026. "Multi-Agent Ethnography: Post-Conventional Anthropological Practice Through Human-AI Collaboration." Human Organization. https://doi.org/10.1080/00664677.2026.2614501.

Artz, Matt. Forthcoming. "AI Anthropology: The Future of Applied Anthropological Practice." In Routledge Handbook of Applied Anthropology, edited by Christina Wasson, Edward B. Liebow, Karine L. Narahara, Ndukuyakhe Ndlovu, and Alaka Wali. New York: Routledge.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ai_anthropology_toolkit-2.1.0.tar.gz (71.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ai_anthropology_toolkit-2.1.0-py3-none-any.whl (77.6 kB view details)

Uploaded Python 3

File details

Details for the file ai_anthropology_toolkit-2.1.0.tar.gz.

File metadata

  • Download URL: ai_anthropology_toolkit-2.1.0.tar.gz
  • Upload date:
  • Size: 71.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for ai_anthropology_toolkit-2.1.0.tar.gz
Algorithm Hash digest
SHA256 36341652abc553ef17b6f17b4894e9be24c36dc70cc832454be857711ab57c97
MD5 1e5b43f2922080f834ca504618fee154
BLAKE2b-256 951775a114119254b1f670ca1a5587362159f05c36f88f0a5616e590ead32469

See more details on using hashes here.

File details

Details for the file ai_anthropology_toolkit-2.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for ai_anthropology_toolkit-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 84dc1c8cd3f7d61cc5abbeb929cbd7c00c5c2b6f97c238f69a21cf26194019df
MD5 ab892ef654a22befd4596bbd277e3701
BLAKE2b-256 9a4528e4686cc98c775cbf198f6ea841aeacb10835cf15ee77104f790080f7c9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page